Required Packages

The following packages are required to run DNPLab:




1.19 or higher


1.5 or higher


3.3 or higher


2.10 or higher

Hydration GUI

Due to cross-platfrom issues of PyQt5, the Hydration GUI is no longer part of DNPLab and needs to be installed separately. The GUI is part of the Han Lab python package. Instructions on how to install and use the GUI can be found on the website of the Han Lab python package.

Installing DNPLab

Installing using pip

The easiest and most convenient way to install DNPLab is by using pip. In a terminal simply type the following command:

$ python -m pip install dnplab

or simply just:

$ pip install dnplab

If you prefer to install DNPLab from the source code, check out our GitHub repository: DNPLab on GitHub. The newest developments are merged into the Development branch.

Confirm Successful Installation

To confirm that your installation of DNPLab was successful type the following command:

$ pip show dnplab

The output will look similar to this (note, the actual version and path to location depends on the local installation):

Name: dnplab
Version: 1.0.3
Summary: dnpLab - Bringing the Power of Python to DNP-NMR Spectroscopy
Author: DNPLab Team
Author-email: None
License: MIT
Location: /Path/to/Package
Requires: numpy, scipy, matplotlib, h5py

Specify DNPLab Version to install

If you wish to install a specific version of DNPLab typ the following comman in a terminal window:

$ pip install dnplab==1.0.11

install Preliminary Release

If you wish to use a pre-release version of DNPLab (downloaded from the GitHub repository) we recommend first uninstalling the current DNPLab version. Clone (or download or fork ...) the desired branch from the GitHub website. In a terminal window navigate into the directory that contains the file and type the following command into the terminal window:

$ python develop

Once you ran the above command, check the path and version of the package by running pip show dnplab. If the version does not match the version of the checked-out branch, you may have to first uninstall DNPLab (pip uninstall dnplab), then re-install the version you would like to use (pip install dnplab) and then running (python develop) if you would like to make your own changes to the code.

Upgrading DNPLab

To upgrade your currently installed version of DNPLab type the following command:

$ pip install dnplab --upgrade

Uninstalling DNPLab

The safest method to uninstall DNPLab is to use pip. Type the following command in a terminal window:

$ python -m pip uninstall dnplab