Metadata-Version: 2.1
Name: dftd_labeler
Version: 0.1.0
Summary: A convenience tool to label structures with DFT dispersion corrections.
Home-page: https://github.com/tcnicholas/dftd_labeler
Author: Thomas C Nicholas
Author-email: thomas.nicholas@chem.ox.ac.uk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
Requires-Dist: ase

# DFT Database Processor

This Python-based project is designed to process a database of molecular 
structures and label them with DFT-D4 corrections. It reads an existing 
database, applies the desired DFT method and dispersion scheme, 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
```

## Usage

After installation, you can use the tool as a command-line program:

```css
dft_db_processor -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
dft_db_processor -i my_database.extxyz -o output_database.extxyz -d 4
```

## Dependencies

This project depends on several Python libraries, including ase, dftd4.ase, 
dftd3.ase, and more. 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.


## Within conda

```bash
conda create -n dftd23 python=3.9 -y
conda activate dftd23

conda install -c conda-forge ase simple-dftd3 dftd3-python dftd4 dftd4-python -y
```
