Skip to main content

Tau2

Tau2 is a python package for simulating magnetic relaxation.

Installation via pip

Install tau2 using pip (if using a shared machine, add the --user argument after install)

pip install tau2

Updating

Update the code using pip (if using a shared machine, add the --user argument after install)

pip install tau2 --upgrade

Usage

The tau2 command line interface can be invoked with

tau2 -h

which prints a list of available subprograms.

Additional options for the raman and orbach programs can be viewed with --advanced_help.

Citation

If you've used Tau2 in your work, please cite the Tau2 paper: Atkinson, B. E. & Chilton, N. F. Tau2: A program for the simulation of magnetic relaxation. J. Chem. Theory Comput. https://doi.org/10.1021/acs.jctc.6c00890 (2026)

Documentation

The documentation for this package is hosted by gitlab, and is automatically generated whenever new code is committed to the main branch. The automatic generation of this documentation relies on a common layout for comments and docstrings within the code, see contributing for more information.

Installation with pip editable install

Only do this if you are developing (i.e. changing) the code.

Clone a copy of this repository, preferably while within a directory called git

mkdir -p git; cd git
git clone https://gitlab.com/chilton-group/tau2

Navigate to the package directory

cd tau2/packages

and install the package in editable mode (if using a shared machine, add the --user argument after install)

pip install -e .

When you're done developing (i.e. your changes have been merged to the master), or if you just want to use the current release version of the package, uninstall using pip

pip uninstall tau2

and follow the Installation via pip instructions above.

Development

Before making changes to this repository, please follow the steps outlined in the Chilton group wiki.

Bugs

If you believe you have a bug, please check that you are using the most up to date version of the code.

If that does not fix the problem, please create an issue on GitLab detailing the following:

  • The commands you entered
  • The error message

Remember to simplify the problem as much as possible in order to provide a minimum working example, e.g. an example for a small molecule rather than one with 100000 atoms.

Then, look at the code, try and figure out what you think is wrong if possible, and include this in your issue.

Metadata

Release files for tau2 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tau2 3.0.0
File Size Uploaded Provenance Actions
tau2-3.0.0.tar.gz 84.2 kB Without provenance Details for tau2-3.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tau2 3.0.0
File Interpreter ABI Platform Actions
tau2-3.0.0-py3-none-any.whl Python 3 none any Details for tau2-3.0.0-py3-none-any.whl

Total release size: 164.1 kB

Release files / tau2-3.0.0.tar.gz

Download URL tau2-3.0.0.tar.gz
Size 84.2 kB
Tags Source
SHA-256 checksum
How to use checksums
0505f3049544c9e0c7d7203d6f7fcc1ed802b8ec02704d0f5d06d1e292dfd361
BLAKE2b-256 checksum
How to use checksums
7f6a0af987cab049bc423e9a3629e6e3d2781403ce961e8566fc4f5d348a975e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Release files / tau2-3.0.0-py3-none-any.whl

Download URL tau2-3.0.0-py3-none-any.whl
Size 79.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
400902643d5ce61c02e8e5f2c79464817ac12d86a112681f74c52af1f9070599
BLAKE2b-256 checksum
How to use checksums
6b21c2e8f8b278ae5d27e0c01c001ef0c2051a139a5cdd20a45e8c9b6e72845a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Security for tau2 3.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page