# Enhanced Monte Carlo (EMC) Python Interface
[](https://pypi.python.org/pypi/emc-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. No pre-installation of EMC is needed.
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.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": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "EMC, Molecular Dynamics, LAMMPS, SMILES, Simulation",
"author": "Kuan-Hsuan (Kevin) Shen",
"author_email": "kevinshen56714@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/de/6d/245197cc73bad4b29ec43a7f40e683716df8cb3b3ab47c0bc73f5ebf1182/emc-pypi-2024.8.1.post1.tar.gz",
"platform": null,
"description": "# Enhanced Monte Carlo (EMC) Python Interface\n\n[](https://pypi.python.org/pypi/emc-pypi/)\n[](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. No pre-installation of EMC is needed.\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.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": null,
"summary": "Python interface for the Enhanced Monte Carlo (EMC) package",
"version": "2024.8.1.post1",
"project_urls": {
"Homepage": "https://github.com/kevinshen56714/emc-pypi"
},
"split_keywords": [
"emc",
" molecular dynamics",
" lammps",
" smiles",
" simulation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "403a161a18f40c7d65588ae9bdfbf9d51e9ee7c4c26a4a760cbdb29a9f39ac11",
"md5": "235ab4d3d0fea16c5ad4764f0915fd06",
"sha256": "02c925dc432a425e220a5badcc98843505c89a61a6aa03e8cc5cf18d0b0d1180"
},
"downloads": -1,
"filename": "emc_pypi-2024.8.1.post1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "235ab4d3d0fea16c5ad4764f0915fd06",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 21573167,
"upload_time": "2024-07-28T22:42:48",
"upload_time_iso_8601": "2024-07-28T22:42:48.778355Z",
"url": "https://files.pythonhosted.org/packages/40/3a/161a18f40c7d65588ae9bdfbf9d51e9ee7c4c26a4a760cbdb29a9f39ac11/emc_pypi-2024.8.1.post1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "de6d245197cc73bad4b29ec43a7f40e683716df8cb3b3ab47c0bc73f5ebf1182",
"md5": "216b590c461e63593a6adeb4f0bc6533",
"sha256": "ac51dbd29bbb84cf73ca73cddcda0b3c16cdfc1b7aed48451d76a3e3580e35c7"
},
"downloads": -1,
"filename": "emc-pypi-2024.8.1.post1.tar.gz",
"has_sig": false,
"md5_digest": "216b590c461e63593a6adeb4f0bc6533",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 21200709,
"upload_time": "2024-07-28T22:42:51",
"upload_time_iso_8601": "2024-07-28T22:42:51.923848Z",
"url": "https://files.pythonhosted.org/packages/de/6d/245197cc73bad4b29ec43a7f40e683716df8cb3b3ab47c0bc73f5ebf1182/emc-pypi-2024.8.1.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-28 22:42:51",
"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"
}
JSON
