# **Auto3D**
<a href="https://pypi.org/project/Auto3D/" target="_blank"><img src="https://img.shields.io/badge/pypi-url-informational" alt="pypi_link"></a>
<img width="1109" alt="image" src="https://user-images.githubusercontent.com/60156077/180329514-c72d7b92-91a8-431b-9339-1445d5cacd20.png">
**Auto3D** is a Python package for generating low-energy conformers from SMILES/SDF. It automatizes the stereoisomer enumeration and duplicate filtering process, 3D building process, fast geometry optimization and ranking process using ANI and AIMNet neural network atomistic potentials. Auto3D can be imported as a Python library, or be excuted from the terminal.
Please check out the information at [**documentation**](https://auto3d.readthedocs.io/en/latest/index.html), including [installation](https://auto3d.readthedocs.io/en/latest/installation.html), [usage](https://auto3d.readthedocs.io/en/latest/usage.html), [API](https://auto3d.readthedocs.io/en/latest/api.html) and [citation](https://auto3d.readthedocs.io/en/latest/citation.html).
- **Jupyter notebook examples** can be found [here](https://github.com/isayevlab/Auto3D_pkg/tree/main/example)
- To-do list for **improvement and new features** can be found [here](https://github.com/isayevlab/Auto3D_pkg/discussions). You are welcomed to share your thoughts.
- Bugs go to the [issues](https://github.com/isayevlab/Auto3D_pkg/issues)
## Minimum Dependencies Installatioin
1. Python >= 3.7
2. [RDKit](https://www.rdkit.org/docs/Install.html) >= 2022.03.1(For the isomer engine)
3. [PyTorch](https://pytorch.org/get-started/locally/) >= 2.1.0 (For the optimization engine)
If you have an environment with the above dependencies, Auto3D can be installed by
```{bash}
pip install Auto3D
```
Otherwise, you can create an environment and install Auto3D. In a terminal, the following code will create a environment named `auto3D` with Auto3D and its minimum dependencies installed.
```{bash}
git clone https://github.com/isayevlab/Auto3D_pkg.git
cd Auto3D_pkg
conda env create --file installation.yml --name auto3D
conda activate auto3D
pip install Auto3D
```
Raw data
{
"_id": null,
"home_page": "https://github.com/isayevlab/Auto3D_pkg",
"name": "AcAuto3D",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "'Zhen Liu, Tetiana Zubatiuk, Adrian Roitberg, Olexandr Isayev'",
"author_email": "liu5@andrew.cmu.edu, tetiana@zubatyuk.com, roitberg@ufl.edu, olexandr@olexandrisayev.com",
"download_url": "https://files.pythonhosted.org/packages/09/46/8395f497d028d950533018fdbbc1b3de3fb6f751e18c2237f57c73d1aab8/AcAuto3D-1.0.1.tar.gz",
"platform": null,
"description": "# **Auto3D**\n<a href=\"https://pypi.org/project/Auto3D/\" target=\"_blank\"><img src=\"https://img.shields.io/badge/pypi-url-informational\" alt=\"pypi_link\"></a>\n\n\n\n\n<img width=\"1109\" alt=\"image\" src=\"https://user-images.githubusercontent.com/60156077/180329514-c72d7b92-91a8-431b-9339-1445d5cacd20.png\">\n\n\n\n\n**Auto3D** is a Python package for generating low-energy conformers from SMILES/SDF. It automatizes the stereoisomer enumeration and duplicate filtering process, 3D building process, fast geometry optimization and ranking process using ANI and AIMNet neural network atomistic potentials. Auto3D can be imported as a Python library, or be excuted from the terminal.\n\nPlease check out the information at [**documentation**](https://auto3d.readthedocs.io/en/latest/index.html), including [installation](https://auto3d.readthedocs.io/en/latest/installation.html), [usage](https://auto3d.readthedocs.io/en/latest/usage.html), [API](https://auto3d.readthedocs.io/en/latest/api.html) and [citation](https://auto3d.readthedocs.io/en/latest/citation.html).\n\n- **Jupyter notebook examples** can be found [here](https://github.com/isayevlab/Auto3D_pkg/tree/main/example)\n- To-do list for **improvement and new features** can be found [here](https://github.com/isayevlab/Auto3D_pkg/discussions). You are welcomed to share your thoughts.\n- Bugs go to the [issues](https://github.com/isayevlab/Auto3D_pkg/issues)\n\n## Minimum Dependencies Installatioin\n1. Python >= 3.7\n2. [RDKit](https://www.rdkit.org/docs/Install.html) >= 2022.03.1(For the isomer engine)\n3. [PyTorch](https://pytorch.org/get-started/locally/) >= 2.1.0 (For the optimization engine)\n\nIf you have an environment with the above dependencies, Auto3D can be installed by\n```{bash}\npip install Auto3D\n```\nOtherwise, you can create an environment and install Auto3D. In a terminal, the following code will create a environment named `auto3D` with Auto3D and its minimum dependencies installed.\n```{bash}\ngit clone https://github.com/isayevlab/Auto3D_pkg.git\ncd Auto3D_pkg\nconda env create --file installation.yml --name auto3D\nconda activate auto3D\npip install Auto3D\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Generating Low-energy 3D Conformers from SMILES/SDF",
"version": "1.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/isayevlab/Auto3D_pkg/issues",
"Homepage": "https://github.com/isayevlab/Auto3D_pkg"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6045f4fe1e7ac94d3b23171c7ce35e34e63c5f76bab09efb52a769f0b36842b3",
"md5": "886e79aba921be034404da5ec141829c",
"sha256": "68a0d865121c883c2d11d64d95979aa2e687e55e6c70c825e7a96687a07ef2af"
},
"downloads": -1,
"filename": "AcAuto3D-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "886e79aba921be034404da5ec141829c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 49907244,
"upload_time": "2024-03-22T09:53:03",
"upload_time_iso_8601": "2024-03-22T09:53:03.949583Z",
"url": "https://files.pythonhosted.org/packages/60/45/f4fe1e7ac94d3b23171c7ce35e34e63c5f76bab09efb52a769f0b36842b3/AcAuto3D-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "09468395f497d028d950533018fdbbc1b3de3fb6f751e18c2237f57c73d1aab8",
"md5": "6866267515a327c717364a5a43dc966f",
"sha256": "bd42237c21d18dfd52dcbfa53f63bdaab312ec1e3ce6842cb84727b3045399dd"
},
"downloads": -1,
"filename": "AcAuto3D-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "6866267515a327c717364a5a43dc966f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 49826991,
"upload_time": "2024-03-22T09:53:33",
"upload_time_iso_8601": "2024-03-22T09:53:33.311793Z",
"url": "https://files.pythonhosted.org/packages/09/46/8395f497d028d950533018fdbbc1b3de3fb6f751e18c2237f57c73d1aab8/AcAuto3D-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-22 09:53:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "isayevlab",
"github_project": "Auto3D_pkg",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "acauto3d"
}
JSON
