Skip to content

About

Simple script to compute chemical potentials of molecules in the RRHO model

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

compute_free_H

Command-line tools to compute the chemical potential (molar Gibbs free energy contribution) of a molecule in the rigid-rotor harmonic-oscillator (RRHO) approximation, starting from the results of a quantum-chemical harmonic frequency calculation.

The package provides two command-line tools:

  • read-harmonic-frequency-results extracts atomic coordinates, masses, and harmonic frequencies from the output of a quantum-chemical calculation and stores them in a single .npz file. Currently, only TURBOMOLE output is supported.
  • compute-free-h reads such an .npz file and computes the translational, rotational, and vibrational partition functions, the zero-point vibrational energy (ZPVE), and the resulting chemical potential, using the RRHO model.

Installation

Requires Python >= 3.9. Clone the repository and install it with pip:

git clone https://github.com/KoehnLab/compute_free_H.git
cd compute_free_H
pip install .

This installs the compute-free-h and read-harmonic-frequency-results commands into your environment. For development (editable install plus test dependencies), use:

pip install -e ".[test]"

Usage

1. Extract frequency information from a calculation

read-harmonic-frequency-results --turbomole-dir path/to/turbomole/output -o my_molecule.npz

This reads coord, vibspectrum, and vib_normal_modes from the given directory and writes my_molecule.npz, containing element symbols, atomic coordinates, atomic masses, harmonic frequencies, and mass-weighted normal modes.

2. Compute the chemical potential

compute-free-h --freq-info my_molecule.npz --temperature 298.15 --pressure 0.1

Relevant options (see compute-free-h --help for the full list):

Option Description Default
--freq-info PATH .npz file produced by read-harmonic-frequency-results (required)
--temperature T Temperature in K 298.15
--pressure p Pressure in MPa 0.1
--symmetry-factor sigma External symmetry number used in q(rot) 1.0
--correction type Treatment of low-frequency vibrational modes in q(vib): none, scale, or rotator none
--thr-frequency vib Threshold/switching frequency (cm⁻¹) used by --correction 50.0

The rotator correction implements the quasi-rigid-rotor treatment of low-frequency modes described by Grimme, Chem. Eur. J. 18, 9955 (2012), DOI: 10.1002/chem.201200497. It has no effect on the ZPVE, only on q(vib).

Example with the bundled test data

The test_data/ directory contains TURBOMOLE output and pre-extracted .npz files for two example molecules that can be used to try out the tools:

compute-free-h --freq-info test_data/Benzophenone_vibs.npz

Running the tests

pip install -e ".[test]"
pytest

Citing

If you use this software, please cite it as described in CITATION.cff.

License

MIT — see LICENSE.

About

Simple script to compute chemical potentials of molecules in the RRHO model

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages