Skip to main content

Parameter Optimisation by Iterative Spectral Evaluation, a TopSpin-compatible NMR package

Project description

Parameter Optimisation by Iterative Spectral Evaluation

GitHub Actions Build Status GitHub Actions Documentation Status PyPI version License Zenodo DOI

Jonathan Yong and Mohammadali Foroozandeh, University of Oxford

Anal. Chem. 2021, 93 (31), 10735–10739. DOI: 10.1021/acs.analchem.1c01767


POISE is a Python package for the numerical optimisation of NMR parameters. It works by iteratively acquiring NMR spectra with different parameters and using a cost function to determine the optimal point.

The software comprises two parts:

  • the user-facing frontend, which runs in Bruker's TopSpin software. It can be executed from the TopSpin command line, or called from an AU or Python script (the documentation contains more instructions on this).

  • the backend, which is hidden from the user; it runs on a system installation of Python 3.6+.


To install POISE, you will need:

  • TopSpin. The minimum tested version is 3.6; however, this should work on any version of TopSpin that has Python 2.7 internally bundled (older versions of Python 2 are not currently supported). To check which version of Python comes with TopSpin, follow these instructions.

    Note that other instrument manufacturers are not currently supported.

  • Python 3.6 or later. This refers to a system installation, which is entirely separate from that in TopSpin. Please download and install that (many instructions are available online).

POISE can then be installed using pip (which uses the system installation of Python):

python -m pip install nmrpoise   # or 'python3'

If any errors occur, please see the documentation, or contact us.

To upgrade or reinstall POISE use:

python -m pip install --upgrade nmrpoise --no-cache-dir

Note that the --no-cache-dir flag is necessary if you are reinstalling (its purpose is explained in the documentation).


The documentation is hosted at; it contains complete instructions on how to set POISE up and use it.

There is also a video guide available at

Contact us

Any feedback, questions, or bugs? Please create a GitHub issue or email us: we can be reached at

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nmrpoise-1.2.3.tar.gz (22.7 MB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page