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-resultsextracts atomic coordinates, masses, and harmonic frequencies from the output of a quantum-chemical calculation and stores them in a single.npzfile. Currently, only TURBOMOLE output is supported.compute-free-hreads such an.npzfile and computes the translational, rotational, and vibrational partition functions, the zero-point vibrational energy (ZPVE), and the resulting chemical potential, using the RRHO model.
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]"read-harmonic-frequency-results --turbomole-dir path/to/turbomole/output -o my_molecule.npzThis 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.
compute-free-h --freq-info my_molecule.npz --temperature 298.15 --pressure 0.1Relevant 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).
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.npzpip install -e ".[test]"
pytestIf you use this software, please cite it as described in CITATION.cff.
MIT — see LICENSE.