# polyply
[](https://codecov.io/gh/marrink-lab/polyply_1.0)
[](https://github.com/marrink-lab/polyply_1.0/actions)
[](https://badge.fury.io/py/polyply)
[](https://arxiv.org/abs/2105.05890)
[](https://doi.org/10.1038/s41467-021-27627-4)
## Functionality
Polyply is a python suite designed to facilitate the generation of input files and system coordinates for simulating
(bio)macromolecules such as synthetic polymers or polysaccharides. Input files can be generated either from user
specified building blocks or by using the polymers available in the library. The library currently includes polymer
definitions for the GROMOS (2016H66 & 54A6), OPLS, Parmbsc1, and Martini (2 & 3) force-fields. Coordinates are generated
by a multiscale random-walk protocol that is able to generate condensed phase systems at target density, as well as
more heterogeneous systems such as aqueous two phase systems. In addition, polyply allows to tailor initial chain
conformations by providing a build file. For example, the persistence length can be used to control the initial chain
dimensions. The [quick start](https://github.com/marrink-lab/polyply_1.0/wiki/Quick-Start) section in the wiki gives
an overview of the most important commands. In addition, [tutorials][wiki] are provided for more in-depth information
on how to use the program. Tutorials include how to generate
[Martini polymer systems](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-martini-polymer-melts) and
[write input files](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-writing-.ff-input-files).
More details on the algorithm and verification can be found in the [publication](https://doi.org/10.1038/s41467-021-27627-4).
Make sure to always verify the results and give appropriate credit to the developers of the
force-field, molecule parameters and this program.
## Quick references
[Installation Guide](https://github.com/marrink-lab/polyply_1.0/wiki/Installation)\
[FAQs](https://github.com/marrink-lab/polyply_1.0/wiki/FAQs)\
[Current Polyply Polymer Library](./LIBRARY.md)\
[Submissions to Martini Polymer Library](https://github.com/marrink-lab/polyply_1.0/wiki/Submit-polymer-parameters)\
[Tutorial: Martini Polymers](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-martini-polymer-melts)\
[Tutorial: GROMOS Polymers](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-GROMOS-polymer-melts)\
[Tutorial: PEGylated lipid bilayers](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-PEGylated-lipid-bilayers)\
[Tutorial: Single-stranded DNA](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-Single-stranded-circular-DNA)
## News
- (Feb 8, 22') **Featured Research Article in Nature Communcations.** Our article on the polyply software suite is now featured on the [Editors' Highlights](https://www.nature.com/collections/hhfigaahch) for Structural biology, biochemistry and biophysics in Nature Communications. The Editors’ Highlights pages aims to showcase the 50 best papers recently published in an area. The development team is beyond happy to receive this honor.
- (May 23, 22') **Fighting Cancer with polyply.** Dane et al. used polyply to setup simulations of vesicles and lipid nanodiscs (LNDs) containing PEGylated lipids, which are used as nanocarriers for cancer therapeutics. They find that LNDs are more effective in delivery likely due to their higher flexibility. Check it out in [Nature Materials](https://www.nature.com/articles/s41563-022-01251-z).
- (Jan 18, 23') **Towards whole cell simulations with polyply.** In [a perspective on whole-cell simulations](https://www.frontiersin.org/articles/10.3389/fchem.2023.1106495/full) using the Martini force field, Stevens *et al.* utilize polyply to construct the full 0.5 Mio bp chromosome of the Syn3A minimal cell. This impressive task is a good example of the power of the upcoming DNA implementation into polyply and the role of polyply in the Martini Ecosystem.
- (May 11, 23') **Electronic coarse-grained models in polyply.** Curious about simulating non-conjugated radical-containing polymers for all-organic batteries? The models developed [in this work](https://doi.org/10.1021/acs.macromol.3c00141) for PTMA, or poly(TEMPO acrylamide), are avaiable in polyply. There is an all-atom model and different coarse-grained model (Martini 3, iterative Boltzmann inversion), all of which can be flexibly handled by polyply.
## Contributions & Support
We are happy to accept submissions of polymer parameters to the polyply library. To submit parameters simply
open an [issue][bug reports]. More details on submitting parameters can be found
[here](https://github.com/marrink-lab/polyply_1.0/wiki/Submit-polymer-parameters). The code development of polyply is done
on [github]. Contributions are welcome as [bug reports] and [pull requests] from everyone. We are also happy to discuss
any of your projects or hear about how you used polyply in your research project. Let us know on the
[discussions board](https://github.com/marrink-lab/polyply_1.0/discussions) or by tweeting with #CG_MARTINI or #polyplyMD.
## Citation
```
@article{Grunewald2022Polyply,
title={Polyply; a python suite for facilitating simulations of (bio-) macromolecules and nanomaterials},
author={Gr{\"u}newald, Fabian and Alessandri, Riccardo and Kroon, Peter C and
Monticelli, Luca and Souza, Paulo CT and Marrink, Siewert J},
journal={Nature Communications},
volume={13},
pages={68},
doi={https://doi.org/10.1038/s41467-021-27627-4},
year={2022}
}
```
## License
Polyply is distributed under the Apache 2.0 license.
Copyright 2020 University of Groningen
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
The full text of the license is available in the source repository.
[github]: https://github.com/marrink-lab/polyply_1.0
[bug reports]: https://github.com/marrink-lab/polyply_1.0/issues
[pull requests]: https://github.com/marrink-lab/polyply_1.0/pulls
[wiki]:https://github.com/marrink-lab/polyply_1.0/wiki
[pypi_polyply]: https://pypi.org/project/polyply/
[pipdoc]: https://packaging.python.org/tutorials/installing-packages/#installing-packages
Raw data
{
"_id": null,
"home_page": "https://github.com/marrink-lab/polyply_1.0",
"name": "polyply",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "molecular dynamics charmm gromos martini polymers",
"author": "Fabian Grunewald",
"author_email": "f.grunewald@rug.nl",
"download_url": "https://files.pythonhosted.org/packages/16/52/da75ed492dcb85008d81e9d06106e49b42a22da69c9200f4074be378b59c/polyply-1.7.0.tar.gz",
"platform": null,
"description": "# polyply\n\n[](https://codecov.io/gh/marrink-lab/polyply_1.0)\n[](https://github.com/marrink-lab/polyply_1.0/actions)\n[](https://badge.fury.io/py/polyply)\n\n\n[](https://arxiv.org/abs/2105.05890)\n[](https://doi.org/10.1038/s41467-021-27627-4)\n\n## Functionality\nPolyply is a python suite designed to facilitate the generation of input files and system coordinates for simulating\n(bio)macromolecules such as synthetic polymers or polysaccharides. Input files can be generated either from user\nspecified building blocks or by using the polymers available in the library. The library currently includes polymer\ndefinitions for the GROMOS (2016H66 & 54A6), OPLS, Parmbsc1, and Martini (2 & 3) force-fields. Coordinates are generated\nby a multiscale random-walk protocol that is able to generate condensed phase systems at target density, as well as\nmore heterogeneous systems such as aqueous two phase systems. In addition, polyply allows to tailor initial chain\nconformations by providing a build file. For example, the persistence length can be used to control the initial chain\ndimensions. The [quick start](https://github.com/marrink-lab/polyply_1.0/wiki/Quick-Start) section in the wiki gives\nan overview of the most important commands. In addition, [tutorials][wiki] are provided for more in-depth information\non how to use the program. Tutorials include how to generate\n[Martini polymer systems](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-martini-polymer-melts) and\n[write input files](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-writing-.ff-input-files).\nMore details on the algorithm and verification can be found in the [publication](https://doi.org/10.1038/s41467-021-27627-4).\n\nMake sure to always verify the results and give appropriate credit to the developers of the\nforce-field, molecule parameters and this program.\n\n## Quick references\n[Installation Guide](https://github.com/marrink-lab/polyply_1.0/wiki/Installation)\\\n[FAQs](https://github.com/marrink-lab/polyply_1.0/wiki/FAQs)\\\n[Current Polyply Polymer Library](./LIBRARY.md)\\\n[Submissions to Martini Polymer Library](https://github.com/marrink-lab/polyply_1.0/wiki/Submit-polymer-parameters)\\\n[Tutorial: Martini Polymers](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-martini-polymer-melts)\\\n[Tutorial: GROMOS Polymers](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-GROMOS-polymer-melts)\\\n[Tutorial: PEGylated lipid bilayers](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-PEGylated-lipid-bilayers)\\\n[Tutorial: Single-stranded DNA](https://github.com/marrink-lab/polyply_1.0/wiki/Tutorial:-Single-stranded-circular-DNA)\n## News \n- (Feb 8, 22') **Featured Research Article in Nature Communcations.** Our article on the polyply software suite is now featured on the [Editors' Highlights](https://www.nature.com/collections/hhfigaahch) for Structural biology, biochemistry and biophysics in Nature Communications. The Editors\u2019 Highlights pages aims to showcase the 50 best papers recently published in an area. The development team is beyond happy to receive this honor. \n- (May 23, 22') **Fighting Cancer with polyply.** Dane et al. used polyply to setup simulations of vesicles and lipid nanodiscs (LNDs) containing PEGylated lipids, which are used as nanocarriers for cancer therapeutics. They find that LNDs are more effective in delivery likely due to their higher flexibility. Check it out in [Nature Materials](https://www.nature.com/articles/s41563-022-01251-z). \n- (Jan 18, 23') **Towards whole cell simulations with polyply.** In [a perspective on whole-cell simulations](https://www.frontiersin.org/articles/10.3389/fchem.2023.1106495/full) using the Martini force field, Stevens *et al.* utilize polyply to construct the full 0.5 Mio bp chromosome of the Syn3A minimal cell. This impressive task is a good example of the power of the upcoming DNA implementation into polyply and the role of polyply in the Martini Ecosystem.\n- (May 11, 23') **Electronic coarse-grained models in polyply.** Curious about simulating non-conjugated radical-containing polymers for all-organic batteries? The models developed [in this work](https://doi.org/10.1021/acs.macromol.3c00141) for PTMA, or poly(TEMPO acrylamide), are avaiable in polyply. There is an all-atom model and different coarse-grained model (Martini 3, iterative Boltzmann inversion), all of which can be flexibly handled by polyply. \n\n## Contributions & Support\nWe are happy to accept submissions of polymer parameters to the polyply library. To submit parameters simply \nopen an [issue][bug reports]. More details on submitting parameters can be found \n[here](https://github.com/marrink-lab/polyply_1.0/wiki/Submit-polymer-parameters). The code development of polyply is done \non [github]. Contributions are welcome as [bug reports] and [pull requests] from everyone. We are also happy to discuss\nany of your projects or hear about how you used polyply in your research project. Let us know on the \n[discussions board](https://github.com/marrink-lab/polyply_1.0/discussions) or by tweeting with #CG_MARTINI or #polyplyMD.\n\n## Citation\n```\n@article{Grunewald2022Polyply,\n title={Polyply; a python suite for facilitating simulations of (bio-) macromolecules and nanomaterials},\n author={Gr{\\\"u}newald, Fabian and Alessandri, Riccardo and Kroon, Peter C and \n \t Monticelli, Luca and Souza, Paulo CT and Marrink, Siewert J},\n journal={Nature Communications},\n volume={13},\n pages={68},\n doi={https://doi.org/10.1038/s41467-021-27627-4},\n year={2022}\n}\n```\n\n## License\n\nPolyply is distributed under the Apache 2.0 license.\n\n Copyright 2020 University of Groningen\n\n\tLicensed under the Apache License, Version 2.0 (the \"License\");\n\tyou may not use this file except in compliance with the License.\n\tYou may obtain a copy of the License at\n\n\t\thttp://www.apache.org/licenses/LICENSE-2.0\n\n\tUnless required by applicable law or agreed to in writing, software\n\tdistributed under the License is distributed on an \"AS IS\" BASIS,\n\tWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\tSee the License for the specific language governing permissions and\n\tlimitations under the License.\n\nThe full text of the license is available in the source repository.\n\n[github]: https://github.com/marrink-lab/polyply_1.0\n[bug reports]: https://github.com/marrink-lab/polyply_1.0/issues\n[pull requests]: https://github.com/marrink-lab/polyply_1.0/pulls\n[wiki]:https://github.com/marrink-lab/polyply_1.0/wiki\n[pypi_polyply]: https://pypi.org/project/polyply/\n[pipdoc]: https://packaging.python.org/tutorials/installing-packages/#installing-packages\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": null,
"version": "1.7.0",
"project_urls": {
"Homepage": "https://github.com/marrink-lab/polyply_1.0"
},
"split_keywords": [
"molecular",
"dynamics",
"charmm",
"gromos",
"martini",
"polymers"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6ad83cb2ff99c9171204e1af885991245791a75b7911706e4c82a40462407ef7",
"md5": "e8fe87f7bfacdbfb16d623412c5c1b46",
"sha256": "816ba8c8375ff6ce2a7b6a53da05b054c31693fc00f1dcd7cfb9a0fb3a5a41f2"
},
"downloads": -1,
"filename": "polyply-1.7.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "e8fe87f7bfacdbfb16d623412c5c1b46",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 723514,
"upload_time": "2024-04-27T10:36:19",
"upload_time_iso_8601": "2024-04-27T10:36:19.697319Z",
"url": "https://files.pythonhosted.org/packages/6a/d8/3cb2ff99c9171204e1af885991245791a75b7911706e4c82a40462407ef7/polyply-1.7.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1652da75ed492dcb85008d81e9d06106e49b42a22da69c9200f4074be378b59c",
"md5": "68cd858360ad5a1146809e6641351deb",
"sha256": "27ec0a36f459ff485a04847487db0bee0ff8f1fc4075bc6b5b7779e7bc54d0cd"
},
"downloads": -1,
"filename": "polyply-1.7.0.tar.gz",
"has_sig": false,
"md5_digest": "68cd858360ad5a1146809e6641351deb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 614462,
"upload_time": "2024-04-27T10:36:22",
"upload_time_iso_8601": "2024-04-27T10:36:22.977987Z",
"url": "https://files.pythonhosted.org/packages/16/52/da75ed492dcb85008d81e9d06106e49b42a22da69c9200f4074be378b59c/polyply-1.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-27 10:36:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "marrink-lab",
"github_project": "polyply_1.0",
"travis_ci": true,
"coveralls": true,
"github_actions": true,
"lcname": "polyply"
}
JSON
