![image](https://github.com/kangmg/aimDIAS/assets/59556369/cb3a401d-6ea2-4a26-85e4-085c143d6485)
aim(aimnet2) + DIAS(distortion interaction analysis)
---
`aimDIAS` is a Python package compatible with IPython that enables SUPER-FAST Distortion Interaction Analysis (or activation strain analysis) using aimnet2 models.
## Colab Tutorials
aimDIAS is currently in ***beta version***. Functions may change depending on the version, so please check the version number.
|notebook| aimDIAS version|description|
|:-:|:-:|:-:|
|[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](link) | v. 1.0.1 | basic tutorials |
## Usage
For detail, see `docs/*`, `notebooks/*`
- Draw your molecule
```python
from aimDIAS import draw_xyz
draw_xyz("h2o.xyz", charge=0)
```
- Run calculation
```python
from aimDIAS import aimDIAS_run
fp = {
"frag_1" : (-1, [1, 2]),
"frag_2" : (+1, [3])
}
aimDIAS_run(trajFile="h2o.xyz", fragments_params=fp)
```
- Plot your Result without calculation
```python
from aimDIAS import aimDIAS_run
gp = {"distance" : "1 2"}
fp = {
"frag_1" : (-1, [1, 2]),
"frag_2" : (+1, [3])
}
aimDIAS_run(trajFile="h2o.xyz", fragments_params=fp, mode="plot", axis_type="distance", geo_param=gp)
```
## Install
1. pip
```shell
pip install aimDIAS
```
2. git clone
```shell
# in terminal #
git clone https://github.com/kangmg/aimDIAS
# since `git clone` doesn't directly install git lfs files, it contains metadata only. You'll need to manually remove it. Models will be automatically downloaded.
rm path/to/aimDIAS/aimDIAS/models/*
pip install -q -r path/to/aimDIAS/requirements.txt
```
```python
# in python #
import sys
sys.path.append("path/to/aimDIAS")
```
## Requirements
python >= 3.10.0
## Bug Report
kangmg@korea.ac.kr or [issue in github](https://github.com/kangmg/aimDIAS/issues)
> *I'm always happy to hear feedback and suggestions. Feel free to contact me anytime.*
## TODO
- add auto_fragmentation
- user-friendly fragmentation GUI
- enhance the plot style for publication-quality
- json to table formatter
- more sample data
- fp enables support for string format
- axis validation plot
- add GPU mode
Raw data
{
"_id": null,
"home_page": "https://github.com/kangmg/aimDIAS",
"name": "aimDIAS",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10.0",
"maintainer_email": null,
"keywords": "chemistry, computational chemistry, machine learning",
"author": "Kang mingi",
"author_email": "kangmg@korea.ac.kr",
"download_url": "https://files.pythonhosted.org/packages/a4/91/e74bbf252ed698cbca730b7633cbfb8466777cc77441a8d48d76b5794457/aimDIAS-1.0.1.tar.gz",
"platform": null,
"description": "![image](https://github.com/kangmg/aimDIAS/assets/59556369/cb3a401d-6ea2-4a26-85e4-085c143d6485)\r\n\r\naim(aimnet2) + DIAS(distortion interaction analysis)\r\n---\r\n`aimDIAS` is a Python package compatible with IPython that enables SUPER-FAST Distortion Interaction Analysis (or activation strain analysis) using aimnet2 models.\r\n\r\n## Colab Tutorials\r\naimDIAS is currently in ***beta version***. Functions may change depending on the version, so please check the version number.\r\n\r\n|notebook| aimDIAS version|description|\r\n|:-:|:-:|:-:|\r\n|[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](link) | v. 1.0.1 | basic tutorials |\r\n\r\n## Usage\r\nFor detail, see `docs/*`, `notebooks/*`\r\n\r\n- Draw your molecule\r\n```python\r\nfrom aimDIAS import draw_xyz\r\n\r\ndraw_xyz(\"h2o.xyz\", charge=0)\r\n```\r\n \r\n- Run calculation\r\n```python\r\nfrom aimDIAS import aimDIAS_run\r\n\r\nfp = {\r\n \"frag_1\" : (-1, [1, 2]),\r\n \"frag_2\" : (+1, [3])\r\n }\r\n\r\naimDIAS_run(trajFile=\"h2o.xyz\", fragments_params=fp)\r\n```\r\n\r\n- Plot your Result without calculation\r\n```python\r\nfrom aimDIAS import aimDIAS_run\r\n\r\ngp = {\"distance\" : \"1 2\"}\r\n\r\nfp = {\r\n \"frag_1\" : (-1, [1, 2]),\r\n \"frag_2\" : (+1, [3])\r\n }\r\n\r\naimDIAS_run(trajFile=\"h2o.xyz\", fragments_params=fp, mode=\"plot\", axis_type=\"distance\", geo_param=gp)\r\n```\r\n\r\n## Install\r\n1. pip \r\n```shell\r\npip install aimDIAS\r\n```\r\n\r\n2. git clone\r\n```shell\r\n# in terminal #\r\n\r\ngit clone https://github.com/kangmg/aimDIAS\r\n\r\n# since `git clone` doesn't directly install git lfs files, it contains metadata only. You'll need to manually remove it. Models will be automatically downloaded.\r\nrm path/to/aimDIAS/aimDIAS/models/*\r\n\r\npip install -q -r path/to/aimDIAS/requirements.txt\r\n```\r\n```python\r\n# in python #\r\n\r\nimport sys\r\nsys.path.append(\"path/to/aimDIAS\")\r\n```\r\n\r\n## Requirements\r\npython >= 3.10.0\r\n\r\n## Bug Report\r\nkangmg@korea.ac.kr or [issue in github](https://github.com/kangmg/aimDIAS/issues)\r\n\r\n> *I'm always happy to hear feedback and suggestions. Feel free to contact me anytime.*\r\n\r\n## TODO\r\n- add auto_fragmentation\r\n- user-friendly fragmentation GUI\r\n- enhance the plot style for publication-quality\r\n- json to table formatter\r\n- more sample data\r\n- fp enables support for string format\r\n- axis validation plot\r\n- add GPU mode\r\n",
"bugtrack_url": null,
"license": null,
"summary": "SUPER FAST D/I analysis with aimnet2",
"version": "1.0.1",
"project_urls": {
"Homepage": "https://github.com/kangmg/aimDIAS"
},
"split_keywords": [
"chemistry",
" computational chemistry",
" machine learning"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f60dec872199d821871bf8f0814c0106372d6c13a7bb3e898c5b40f1a2731335",
"md5": "0cc60e3fd643d47f4fe2779531060ee8",
"sha256": "5cb1f2b2d7fe3b0811c0d3ecb5fcdd0512bf4625a159d3d098b5d186a3e99977"
},
"downloads": -1,
"filename": "aimDIAS-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0cc60e3fd643d47f4fe2779531060ee8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10.0",
"size": 69457319,
"upload_time": "2024-05-04T10:24:29",
"upload_time_iso_8601": "2024-05-04T10:24:29.618698Z",
"url": "https://files.pythonhosted.org/packages/f6/0d/ec872199d821871bf8f0814c0106372d6c13a7bb3e898c5b40f1a2731335/aimDIAS-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a491e74bbf252ed698cbca730b7633cbfb8466777cc77441a8d48d76b5794457",
"md5": "9535120c9670f36b699c6d2b621d17f3",
"sha256": "d85d5c60a38255b822bd84444c106be615fd6e7939cf3f2fe6471864a2ec0215"
},
"downloads": -1,
"filename": "aimDIAS-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "9535120c9670f36b699c6d2b621d17f3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10.0",
"size": 69335555,
"upload_time": "2024-05-04T10:24:37",
"upload_time_iso_8601": "2024-05-04T10:24:37.162365Z",
"url": "https://files.pythonhosted.org/packages/a4/91/e74bbf252ed698cbca730b7633cbfb8466777cc77441a8d48d76b5794457/aimDIAS-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-04 10:24:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "kangmg",
"github_project": "aimDIAS",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "matplotlib",
"specs": []
},
{
"name": "numpy",
"specs": []
},
{
"name": "requests",
"specs": []
},
{
"name": "ase",
"specs": [
[
">=",
"3.22.1"
]
]
},
{
"name": "torch",
"specs": [
[
">=",
"2.2.1"
]
]
},
{
"name": "rdkit",
"specs": [
[
">=",
"2023.09.6"
]
]
},
{
"name": "py3Dmol",
"specs": [
[
">=",
"2.1.0"
]
]
}
],
"lcname": "aimdias"
}