Download and Installation

The entire package for is available from the Python Package Index, containing the source code and examples. The documentation is hosted on Read the Docs.

The latest development version is available on GitHub. Further examples are available in Jupyter notebooks.


The module requires Numpy. The code is compatible with both Python 2 and 3.


The code is available on PyPI, hence it can be installed by

$ sudo pip install trottersuzuki

If you want the latest git version, first clone the repository and generate the Python version. Note that it requires autotools and swig.

$ git clone
$ cd trotter-suzuki-mpi
$ ./
$ ./configure --without-mpi --without-cuda
$ make python

Then follow the standard procedure for installing Python modules from the src/Python folder:

$ sudo python install

To install with CUDA support, set the CUDAHOME environment variable before calling the Python install.

Build on Mac OS X

Before installing using pip, gcc should be installed first. As of OS X 10.9, gcc is just symlink to clang. To build trottersuzuki and this extension correctly, it is recommended to install gcc using something like:

$ brew install gcc48

and set environment using:

export CC=/usr/local/bin/gcc
export CXX=/usr/local/bin/g++
export CPP=/usr/local/bin/cpp
export LD=/usr/local/bin/gcc
alias c++=/usr/local/bin/c++
alias g++=/usr/local/bin/g++
alias gcc=/usr/local/bin/gcc
alias cpp=/usr/local/bin/cpp
alias ld=/usr/local/bin/gcc
alias cc=/usr/local/bin/gcc

Then you can issue

$ sudo pip install trottersuzuki