Welcome to tqchem’s documentation!

tqchem is a python package developed by Terra Quantum AG for molecular modelling and simulation. More specifically, it provides algorithms to find conformers of molecules, perform docking simulations, predict spectra, and provides interfaces to various other packages.

The non-commercial version of tqchem comes with limited functionality.

Installation

You can install tqchem from conda via

conda install tqchem -c conda-forge -c https://repo.prefix.dev/terraquantumag

You need a license key to perform simulations with tqchem. You can request non-commercial access via this request form.

Usage

tqchem can be used as an SDK from python via its application programming interface (API) or via its command line interface (CLI). Usage examples for the API can be found in the Examples section and references in the API references. For examples of the CLI see below.

Command Line Interface (CLI)

After installation, tqchem can be executed as a standalone application. To get an overview of all the functionalities, simply type

tqchem --help

To directly get started, you can generate a molecule file with instantly generated conformers using

tqchem generate --smiles 'CCOC' --n_conformers 10

where --n_conformer determines the number of conformers. The result will be a file called COOC.xyz with heuristic conformers.

To run ttconf on these starting conformers, run

tqchem ttconf "CCOC.xyz" --method gfn2-xtb --n_sweeps 8 --rank 3

See the CLI help message (tqchem ttconf --help) for a list of all command options.

Indices and tables