# Enhanced Monte Carlo (EMC) Python Interface
[![PyPI version shields.io](https://img.shields.io/pypi/v/emc-pypi.svg?style=for-the-badge&logo=PyPI&logoColor=blue)](https://pypi.python.org/pypi/emc-pypi/)
[![PyPI download month](https://img.shields.io/pypi/dm/emc-pypi.svg?style=for-the-badge&logo=PyPI)](https://pypi.python.org/pypi/emc-pypi/)
This module is a thin Python wrapper library of the [EMC](http://montecarlo.sourceforge.net/emc/Welcome.html) package that allows you to use all EMC functionalities with Python interface.
EMC creates input structures from SMILES strings and LAMMPS input files for particle simulations with atomistic force fields - Born, COMPASS, PCFF, CHARMM, OPLS, TraPPE or coarse-grained force fields - DPD, Martini, SDK.
- See the [example input files](https://github.com/kevinshen56714/emc-pypi/tree/main/pyemc/emc/examples/setup) on how to prepare EMC input (.esh) files.
- See the [docs](https://github.com/kevinshen56714/emc-pypi/blob/main/pyemc/emc/docs/emc.pdf) to understand more about EMC.
The package works out of the box without pre-installation of EMC or any configuration. Please open an issue if you find something missing or not working as expected.
## Installation
```bash
pip install emc-pypi
```
## Usage
```python
import pyemc
# Run the emc_setup.pl and generate the build.emc file for the build command
pyemc.setup('your-setup-file.esh')
# Or you can pass in arguments like this
pyemc.setup('your-setup-file.esh', '-ntotal=1000', '-field=opls-aa')
# Finally, run the emc executable to create simulation input files
pyemc.build('build.emc')
```
## Example
Example input files are provided in the [example](https://github.com/kevinshen56714/emc-pypi/tree/main/example). Once installed, you can run the example by:
```python
cd example
python example.py
```
The example.esh file creates a system with 80% m/m water and 20% m/m alcohol. More examples are available [here](https://github.com/kevinshen56714/emc-pypi/tree/main/pyemc/emc/examples/setup)
## Citation
In any publication of scientific results based in part or completely on the use of EMC, please cite the original paper:
P.J. in 't Veld and G.C. Rutledge, Macromolecules 2003, 36, 7358 [[link](https://pubs.acs.org/doi/full/10.1021/ma0346658)] [[pdf](https://pubs.acs.org/doi/pdf/10.1021/ma0346658)]
Raw data
{
"_id": null,
"home_page": "https://github.com/kevinshen56714/emc-pypi",
"name": "emc-pypi",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "EMC,Molecular Dynamics,LAMMPS,SMILES,Simulation",
"author": "Kuan-Hsuan (Kevin) Shen",
"author_email": "kevinshen56714@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/f7/6d/c80c9f1d1691ff0d235ccabbcf8c1d692109c137981e85b7d996b1f1cf4c/emc-pypi-2023.8.2.tar.gz",
"platform": null,
"description": "# Enhanced Monte Carlo (EMC) Python Interface\n\n[![PyPI version shields.io](https://img.shields.io/pypi/v/emc-pypi.svg?style=for-the-badge&logo=PyPI&logoColor=blue)](https://pypi.python.org/pypi/emc-pypi/)\n[![PyPI download month](https://img.shields.io/pypi/dm/emc-pypi.svg?style=for-the-badge&logo=PyPI)](https://pypi.python.org/pypi/emc-pypi/)\n\nThis module is a thin Python wrapper library of the [EMC](http://montecarlo.sourceforge.net/emc/Welcome.html) package that allows you to use all EMC functionalities with Python interface.\n\nEMC creates input structures from SMILES strings and LAMMPS input files for particle simulations with atomistic force fields - Born, COMPASS, PCFF, CHARMM, OPLS, TraPPE or coarse-grained force fields - DPD, Martini, SDK.\n\n- See the [example input files](https://github.com/kevinshen56714/emc-pypi/tree/main/pyemc/emc/examples/setup) on how to prepare EMC input (.esh) files.\n- See the [docs](https://github.com/kevinshen56714/emc-pypi/blob/main/pyemc/emc/docs/emc.pdf) to understand more about EMC.\n\nThe package works out of the box without pre-installation of EMC or any configuration. Please open an issue if you find something missing or not working as expected.\n\n## Installation\n\n```bash\npip install emc-pypi\n```\n\n## Usage\n\n```python\nimport pyemc\n\n# Run the emc_setup.pl and generate the build.emc file for the build command\npyemc.setup('your-setup-file.esh')\n\n# Or you can pass in arguments like this\npyemc.setup('your-setup-file.esh', '-ntotal=1000', '-field=opls-aa')\n\n# Finally, run the emc executable to create simulation input files\npyemc.build('build.emc')\n```\n\n## Example\n\nExample input files are provided in the [example](https://github.com/kevinshen56714/emc-pypi/tree/main/example). Once installed, you can run the example by:\n\n```python\ncd example\npython example.py\n```\n\nThe example.esh file creates a system with 80% m/m water and 20% m/m alcohol. More examples are available [here](https://github.com/kevinshen56714/emc-pypi/tree/main/pyemc/emc/examples/setup)\n\n## Citation\n\nIn any publication of scientific results based in part or completely on the use of EMC, please cite the original paper:\nP.J. in 't Veld and G.C. Rutledge, Macromolecules 2003, 36, 7358 [[link](https://pubs.acs.org/doi/full/10.1021/ma0346658)] [[pdf](https://pubs.acs.org/doi/pdf/10.1021/ma0346658)]\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Python interface for the Enhanced Monte Carlo (EMC) package",
"version": "2023.8.2",
"project_urls": {
"Homepage": "https://github.com/kevinshen56714/emc-pypi"
},
"split_keywords": [
"emc",
"molecular dynamics",
"lammps",
"smiles",
"simulation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bc9a1b1b8fd8a892787aa465c29fbb156c47ff9fcf080aa55db406185be255d6",
"md5": "1eed6166605e937f8a6911f7aa2f2488",
"sha256": "82713535a17870ca9a7f0072629f4101209f4fc01240a87b57e86599cc56050e"
},
"downloads": -1,
"filename": "emc_pypi-2023.8.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1eed6166605e937f8a6911f7aa2f2488",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 10044598,
"upload_time": "2023-07-27T22:28:53",
"upload_time_iso_8601": "2023-07-27T22:28:53.793679Z",
"url": "https://files.pythonhosted.org/packages/bc/9a/1b1b8fd8a892787aa465c29fbb156c47ff9fcf080aa55db406185be255d6/emc_pypi-2023.8.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f76dc80c9f1d1691ff0d235ccabbcf8c1d692109c137981e85b7d996b1f1cf4c",
"md5": "b05340fcc9e30c466d1160aa625fff7f",
"sha256": "abd7babe2f0a471a3c81fefb5144029978498abd0e5e1967b628350a7238fc00"
},
"downloads": -1,
"filename": "emc-pypi-2023.8.2.tar.gz",
"has_sig": false,
"md5_digest": "b05340fcc9e30c466d1160aa625fff7f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9856752,
"upload_time": "2023-07-27T22:28:56",
"upload_time_iso_8601": "2023-07-27T22:28:56.558066Z",
"url": "https://files.pythonhosted.org/packages/f7/6d/c80c9f1d1691ff0d235ccabbcf8c1d692109c137981e85b7d996b1f1cf4c/emc-pypi-2023.8.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-27 22:28:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kevinshen56714",
"github_project": "emc-pypi",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "emc-pypi"
}