[](https://zntrack.readthedocs.io/en/latest/)
[](https://github.com/zincware)
[](https://ipsuite.readthedocs.io/en/latest/?badge=latest)
[](https://pubs.acs.org/doi/10.1021/acs.jpcb.3c07187)
[](https://badge.fury.io/py/ipsuite)
[](https://discord.gg/7ncfwhsnm4)
# IPS - The Inter Atomic Potential Suite
IPS provides you with tools to generate Machine Learned Interatomic Potentials.
You can find the documentation at https://ipsuite.readthedocs.io
Install the package to get started or check out an interactive notebook
[](https://mybinder.org/v2/gh/zincware/IPSuite/HEAD)
```python
pip install ipsuite
```
IPSuite relies on third-party ML packages. As these often come with different,
sometimes incompatible requirements, an `ipsuite` installation is barebones. If
you want to run your favorite ML code but are encountered with an import error,
please install the package manually. You can look at the `pyproject.toml` to
find the packages `ipsuite` is tested against.
Examples can be found at:
- https://dagshub.com/PythonFZ/IPS-Examples/src/intro/main.ipynb
- https://dagshub.com/PythonFZ/IPS-Examples/src/graph/main.ipynb
- https://dagshub.com/PythonFZ/IPS-Examples/src/modify_graph/main.ipynb
# Docker Image
We provide an IPSuite docker image for Linux that includes the `apax`, `mace`
and `gap` MLPs. You can use IPSuite directly from within the image by calling:
```sh
docker run -it -v "$(pwd):/app" --gpus all pythonf/ipsuite dvc repro
docker run -it -v "$(pwd):/app" --gpus all pythonf/ipsuite python
docker run -it -v "$(pwd):/app" --gpus all pythonf/ipsuite zntrack list
docker run -it -v "$(pwd):/app" --gpus all --rm -p 8888:8888 pythonf/ipsuite jupyter lab --ip=0.0.0.0 --port=8888 --allow-root
```
## Fix Permission Issues
Running `dvc repro` via the docker container will create files owned by
`root:root`. If you solely use docker this will not cause any issues. If you
switch between docker and a `dvc` version on your host system, you might
encounter permission errors. You can resolve them, by changing the ownership of
the files. You can do this via the host `chown "$(id -u):$(id -g)" -R .` or from
inside the docker container:
```sh
echo $(id -u):$(id -g)
docker run -it -v "$(pwd):/app" pythonf/ipsuite /bin/bash
addgroup --gid $GROUP_ID user
adduser --disabled-password --gecos '' --uid $USER_ID --gid $GROUP_ID user
chown user:user -R .
```
# References
If you use IPSuite in your research and find it helpful please consider citing
us.
```bibtex
@article{zillsCollaborationMachineLearnedPotentials2024,
title = {Collaboration on {{Machine-Learned Potentials}} with {{IPSuite}}: {{A Modular Framework}} for {{Learning-on-the-Fly}}},
shorttitle = {Collaboration on {{Machine-Learned Potentials}} with {{IPSuite}}},
author = {Zills, Fabian and Schäfer, Moritz René and Segreto, Nico and Kästner, Johannes and Holm, Christian and Tovey, Samuel},
date = {2024-04-03},
journaltitle = {The Journal of Physical Chemistry B},
shortjournal = {J. Phys. Chem. B},
publisher = {American Chemical Society},
issn = {1520-6106},
doi = {10.1021/acs.jpcb.3c07187},
}
@misc{zillsZnTrackDataCode2024,
title = {{{ZnTrack}} -- {{Data}} as {{Code}}},
author = {Zills, Fabian and Sch{\"a}fer, Moritz and Tovey, Samuel and K{\"a}stner, Johannes and Holm, Christian},
year = {2024},
eprint={2401.10603},
archivePrefix={arXiv},
}
```
Raw data
{
"_id": null,
"home_page": null,
"name": "ipsuite",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "data-version-control, interatomic potentials, machine-learning, reproducibility",
"author": null,
"author_email": "Fabian Zills <fzills@icp.uni-stuttgart.de>, Moritz Ren\u00e9 Sch\u00e4fer <schaefer@theochem.uni-stuttgart.de>, Nico Segreto <segreto@theochem.uni-stuttgart.de>",
"download_url": "https://files.pythonhosted.org/packages/c9/d5/8ef8b7eb7ef7b1b082daef1573b972594c2eb2d755407c119733739e566d/ipsuite-0.2.4.tar.gz",
"platform": null,
"description": "\n[](https://zntrack.readthedocs.io/en/latest/)\n[](https://github.com/zincware)\n[](https://ipsuite.readthedocs.io/en/latest/?badge=latest)\n[](https://pubs.acs.org/doi/10.1021/acs.jpcb.3c07187)\n[](https://badge.fury.io/py/ipsuite)\n[](https://discord.gg/7ncfwhsnm4)\n\n# IPS - The Inter Atomic Potential Suite\n\n\n\nIPS provides you with tools to generate Machine Learned Interatomic Potentials.\nYou can find the documentation at https://ipsuite.readthedocs.io\n\nInstall the package to get started or check out an interactive notebook\n[](https://mybinder.org/v2/gh/zincware/IPSuite/HEAD)\n\n```python\npip install ipsuite\n```\n\nIPSuite relies on third-party ML packages. As these often come with different,\nsometimes incompatible requirements, an `ipsuite` installation is barebones. If\nyou want to run your favorite ML code but are encountered with an import error,\nplease install the package manually. You can look at the `pyproject.toml` to\nfind the packages `ipsuite` is tested against.\n\nExamples can be found at:\n\n- https://dagshub.com/PythonFZ/IPS-Examples/src/intro/main.ipynb\n- https://dagshub.com/PythonFZ/IPS-Examples/src/graph/main.ipynb\n- https://dagshub.com/PythonFZ/IPS-Examples/src/modify_graph/main.ipynb\n\n# Docker Image\n\nWe provide an IPSuite docker image for Linux that includes the `apax`, `mace`\nand `gap` MLPs. You can use IPSuite directly from within the image by calling:\n\n```sh\ndocker run -it -v \"$(pwd):/app\" --gpus all pythonf/ipsuite dvc repro\ndocker run -it -v \"$(pwd):/app\" --gpus all pythonf/ipsuite python\ndocker run -it -v \"$(pwd):/app\" --gpus all pythonf/ipsuite zntrack list\ndocker run -it -v \"$(pwd):/app\" --gpus all --rm -p 8888:8888 pythonf/ipsuite jupyter lab --ip=0.0.0.0 --port=8888 --allow-root\n```\n\n## Fix Permission Issues\n\nRunning `dvc repro` via the docker container will create files owned by\n`root:root`. If you solely use docker this will not cause any issues. If you\nswitch between docker and a `dvc` version on your host system, you might\nencounter permission errors. You can resolve them, by changing the ownership of\nthe files. You can do this via the host `chown \"$(id -u):$(id -g)\" -R .` or from\ninside the docker container:\n\n```sh\necho $(id -u):$(id -g)\ndocker run -it -v \"$(pwd):/app\" pythonf/ipsuite /bin/bash\naddgroup --gid $GROUP_ID user\nadduser --disabled-password --gecos '' --uid $USER_ID --gid $GROUP_ID user\nchown user:user -R .\n```\n\n# References\n\nIf you use IPSuite in your research and find it helpful please consider citing\nus.\n\n```bibtex\n@article{zillsCollaborationMachineLearnedPotentials2024,\n title = {Collaboration on {{Machine-Learned Potentials}} with {{IPSuite}}: {{A Modular Framework}} for {{Learning-on-the-Fly}}},\n shorttitle = {Collaboration on {{Machine-Learned Potentials}} with {{IPSuite}}},\n author = {Zills, Fabian and Sch\u00e4fer, Moritz Ren\u00e9 and Segreto, Nico and K\u00e4stner, Johannes and Holm, Christian and Tovey, Samuel},\n date = {2024-04-03},\n journaltitle = {The Journal of Physical Chemistry B},\n shortjournal = {J. Phys. Chem. B},\n publisher = {American Chemical Society},\n issn = {1520-6106},\n doi = {10.1021/acs.jpcb.3c07187},\n}\n\n@misc{zillsZnTrackDataCode2024,\n title = {{{ZnTrack}} -- {{Data}} as {{Code}}},\n author = {Zills, Fabian and Sch{\\\"a}fer, Moritz and Tovey, Samuel and K{\\\"a}stner, Johannes and Holm, Christian},\n year = {2024},\n eprint={2401.10603},\n archivePrefix={arXiv},\n}\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "A suite of tools for machine learned interatomic potentials.",
"version": "0.2.4",
"project_urls": {
"Discord": "https://discord.gg/7ncfwhsnm4",
"Documentation": "https://ipsuite.readthedocs.io",
"Releases": "https://github.com/zincware/ipsuite/releases",
"Repository": "https://github.com/zincware/ipsuite"
},
"split_keywords": [
"data-version-control",
" interatomic potentials",
" machine-learning",
" reproducibility"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d7ea5db57ccc75ae94950e2ff282014219db5b9e2c3b7e0cc58ca898d0d09441",
"md5": "5f3f0964b00fa12bf3a0f0a8d70e3517",
"sha256": "577886c074659fc6ea0021145afbde93e2908daedd1c7c4b8c9e5cd3edb4fe71"
},
"downloads": -1,
"filename": "ipsuite-0.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5f3f0964b00fa12bf3a0f0a8d70e3517",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 102698,
"upload_time": "2025-02-17T17:03:26",
"upload_time_iso_8601": "2025-02-17T17:03:26.583292Z",
"url": "https://files.pythonhosted.org/packages/d7/ea/5db57ccc75ae94950e2ff282014219db5b9e2c3b7e0cc58ca898d0d09441/ipsuite-0.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c9d58ef8b7eb7ef7b1b082daef1573b972594c2eb2d755407c119733739e566d",
"md5": "32c232daf2f45d34cc2a7b2a715497e8",
"sha256": "96b03f2b35c9f1a52d55916d987305c4f705ef075332e3e693d8ed98157f215a"
},
"downloads": -1,
"filename": "ipsuite-0.2.4.tar.gz",
"has_sig": false,
"md5_digest": "32c232daf2f45d34cc2a7b2a715497e8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 659182,
"upload_time": "2025-02-17T17:03:27",
"upload_time_iso_8601": "2025-02-17T17:03:27.978663Z",
"url": "https://files.pythonhosted.org/packages/c9/d5/8ef8b7eb7ef7b1b082daef1573b972594c2eb2d755407c119733739e566d/ipsuite-0.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-17 17:03:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zincware",
"github_project": "ipsuite",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ipsuite"
}
JSON
