Skip to content
Geometry optimization code that includes the TRIC coordinate system
Python Other
  1. Python 99.6%
  2. Other 0.4%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
geometric Merge pull request #96 from dgasmith/msgpack Aug 7, 2019


Build Status codecov

This is a geometry optimization code for molecular structures. The code works by calling external software for the energy and gradient through wrapper functions. Q-Chem, TeraChem, Psi4, and Molpro are supported quantum chemistry codes through the command line interface. The PySCF and QCArchive packages also provide interfaces to geomeTRIC for optimization. MM optimizations using OpenMM and Gromacs are also supported through the command line interface.

Authors: Lee-Ping Wang, Chenchen Song

Contributors: Yudong Qiu (Psi4 engine, error handling); Daniel G. A. Smith (Testing framework, QCEngine JSON API); Sebastian Lee (Molpro engine); Chaya Stern (Travis, Conda); Qiming Sun (Custom engine); Alberto Gobbi (Batch energy/gradient, logging); Josh Horton (convergence criteria)

Contact Email:

If this code has benefited your research, please support us by citing:

Wang, L.-P.; Song, C.C. (2016) "Geometry optimization made simple with translation and rotation coordinates", J. Chem, Phys. 144, 214108.

Quick Help

Package dependencies are: Python 2.7, 3.5+ NumPy, Scipy, NetworkX

To install the code from source, run "python install". To install the latest release from pip, run "pip install geometric". To install the latest release from conda-forge, run "conda install -c conda-forge geometric".

To execute the geometry optimizer, run "geometric-optimize". Use "-h" to see the list of command line options.

Generally, you will need a .xyz file for the coordinates and one of the supported quantum chemistry software packages installed on your system.

Supported QM packages are: TeraChem, Q-Chem, Molpro, and Psi4. Supported MM packages are: OpenMM, Gromacs.

Please refer to the example calculations for how to run the code.
The commands to execute the code are contained in "".

You can’t perform that action at this time.