# DFT Dispersion Correction Labeler
This Python-based project is designed to process a database of structures and
label them with DFT dispersion corrections. It reads an existing database,
applies the desired DFT dispersion scheme ontop of the present energy and force
labels, and writes the corrected structures to a new database.
## Installation
We recommend working in a conda environment:
```bash
conda create -n dftd-env python=3.9 -y
conda activate dftd-env
```
Then install conda-specific dependencies:
```bash
conda install -c conda-forge ase simple-dftd3 dftd3-python dftd4 dftd4-python -y
```
Finally, install the tools:
```bash
pip install dftd-labeler
```
## Usage
After installation, you can use the tool as a command-line program:
```css
dftd_labeler -i INPUT_DATABASE_PATH -o OUTPUT_DATABASE_PATH -d DISPERSION_SCHEME
```
## Options
- -m or --dft_method: Specifies the DFT Method to be used. Default is 'SCAN'.
- -i or --input_database: Specifies the path to the database to be read. This is a required argument.
- -o or --output_database: Specifies the path to write the labeled database. This is a required argument.
- -d or --dispersion: Specifies which dispersion scheme to use. Only values 3 or 4 are allowed, indicating DFT-D3 and DFT-D4 respectively. This is a required argument.
## Example
To process a database using the default DFT method (SCAN) and the DFT-D4 dispersion scheme:
```css
dftd_labeler -i my_database.extxyz -o output_database.extxyz -d 4
```
## Dependencies
This project depends on several Python libraries, including ase, dftd4.ase,
dftd3.ase. Ensure you have all required dependencies installed.
## Contributing
Pull requests are welcome. For major changes, please open an issue first to
discuss what you would like to change.
Raw data
{
"_id": null,
"home_page": "https://github.com/tcnicholas/dftd_labeler",
"name": "dftd-labeler",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Thomas C Nicholas",
"author_email": "thomas.nicholas@chem.ox.ac.uk",
"download_url": "https://files.pythonhosted.org/packages/ed/ba/98289442f9fa979a55fe9b2bf0089b827eec9d3019e38d7b9f9a89614990/dftd_labeler-0.1.2.tar.gz",
"platform": null,
"description": "# DFT Dispersion Correction Labeler\n\nThis Python-based project is designed to process a database of structures and \nlabel them with DFT dispersion corrections. It reads an existing database, \napplies the desired DFT dispersion scheme ontop of the present energy and force\nlabels, and writes the corrected structures to a new database.\n\n## Installation\n\nWe recommend working in a conda environment:\n\n```bash\nconda create -n dftd-env python=3.9 -y\nconda activate dftd-env\n```\n\nThen install conda-specific dependencies:\n\n```bash\nconda install -c conda-forge ase simple-dftd3 dftd3-python dftd4 dftd4-python -y\n```\n\nFinally, install the tools:\n\n```bash\npip install dftd-labeler\n```\n\n## Usage\n\nAfter installation, you can use the tool as a command-line program:\n\n```css\ndftd_labeler -i INPUT_DATABASE_PATH -o OUTPUT_DATABASE_PATH -d DISPERSION_SCHEME\n```\n\n## Options\n\n - -m or --dft_method: Specifies the DFT Method to be used. Default is 'SCAN'.\n - -i or --input_database: Specifies the path to the database to be read. This is a required argument.\n - -o or --output_database: Specifies the path to write the labeled database. This is a required argument.\n - -d or --dispersion: Specifies which dispersion scheme to use. Only values 3 or 4 are allowed, indicating DFT-D3 and DFT-D4 respectively. This is a required argument.\n\n## Example\n\nTo process a database using the default DFT method (SCAN) and the DFT-D4 dispersion scheme:\n\n```css\ndftd_labeler -i my_database.extxyz -o output_database.extxyz -d 4\n```\n\n## Dependencies\n\nThis project depends on several Python libraries, including ase, dftd4.ase, \ndftd3.ase. Ensure you have all required dependencies installed.\n\n## Contributing\n\nPull requests are welcome. For major changes, please open an issue first to \ndiscuss what you would like to change.\n",
"bugtrack_url": null,
"license": "",
"summary": "A convenience tool to label structures with DFT dispersion corrections.",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/tcnicholas/dftd_labeler"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "33990a6ca932d27d6c10628412c9ec861ba82bea120c12c0bbea6ff823e46e36",
"md5": "4ab5ae86644cb473b9b002769cca6977",
"sha256": "7f5da6fcf580626a6d79e17aa125b1f2c23a9bc5789930af55e923b638747c54"
},
"downloads": -1,
"filename": "dftd_labeler-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4ab5ae86644cb473b9b002769cca6977",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5905,
"upload_time": "2023-10-05T22:26:02",
"upload_time_iso_8601": "2023-10-05T22:26:02.691457Z",
"url": "https://files.pythonhosted.org/packages/33/99/0a6ca932d27d6c10628412c9ec861ba82bea120c12c0bbea6ff823e46e36/dftd_labeler-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "edba98289442f9fa979a55fe9b2bf0089b827eec9d3019e38d7b9f9a89614990",
"md5": "06eaed6d19e1dd1fe1199469a79ffa3a",
"sha256": "35cb360a0231cdebb147a0299616c2fadd7e64627501e1a85a98c174478f5ae3"
},
"downloads": -1,
"filename": "dftd_labeler-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "06eaed6d19e1dd1fe1199469a79ffa3a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5131,
"upload_time": "2023-10-05T22:26:04",
"upload_time_iso_8601": "2023-10-05T22:26:04.233234Z",
"url": "https://files.pythonhosted.org/packages/ed/ba/98289442f9fa979a55fe9b2bf0089b827eec9d3019e38d7b9f9a89614990/dftd_labeler-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-05 22:26:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tcnicholas",
"github_project": "dftd_labeler",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "dftd-labeler"
}