Institut de Biologie StructuraleGrenoble / France

Contacts relatifs à cet article / FAVIER Adrien / SCHANDA Paul

NMRlib 2.0 : IBS pulse sequence tools for Bruker spectrometers

NMRlib has been developed in the biomolecular NMR group of the Institut de Biologie Structural in Grenoble.
For general questions or comments concerning NMRlib and the solution-state NMR branch, please contact either Adrien Favier or Bernhard Brutscher.
For solid-state NMR related questions please contact Alicia Vallet (alicia.vallet AT ibs DOT fr) or Paul Schanda (for solid-state NMR).


A detailed description of the general philosophy of NMRlib and its implementation for solution-state NMR can be found here ; the solid-state NMR version is described here

(Solution-state NMR version : Favier & Brutscher, J Biomol NMR 2019, 73:199
Solid-state NMR version : Vallet, Favier, Brutscher & Schanda, Magn. Reson. Discuss.,, in review, 2020.)

The NMRlib package contains a suite of jython-based tools designed for Bruker spectrometers (TopSpin versions 3.5–4.0) that allow easy setup, management, and exchange of NMR experiments. A NMR experiment can be set up and executed in a few clicks by navigating through the NMRlib GUI tree structure, without any further parameter adjustment. NMRlib is magnetic-field independent, and thus particularly helpful for laboratories operating multiple NMR spectrometers. NMRlib is easily per-sonalized by adding, deleting, or reorganizing experiments. Additional tools are provided for data processing, visualization, and analysis.

The main features of the IBS pulse sequence tools are the following :

  • Complex NMR experiments can be recorded in an automated way. The user selects the experiments by simply browsing into a Jython emulated frame. All spectrometer dependent parameters are set automatically. A dialog window allows the user to define a few sample dependent parameters, and to select between different options.
  • Shaped pulse parameters (pulse length, power level, and frequency offsets) are calculated within the pulse sequence. If necessary, the spectroscopically relevant parameters (excitation offset and band widths in ppm) are made accessible to the users via constants.
  • The NMR experiments can be easily shared between several NMR instruments (via an NFS mounting point for example). This allows easy maintenance and further development of the library.
  • The IBS pulse sequence package also contains tools that allow you to create your own templates that will be automatically included in the GUI starting from a successful NMR experiment. The created python scripts can then be used on other spectrometers or shared with other users.

NMR experiments in NMRlib

Upon installation, NMRlib comes with both solution- and solid-state NMR experiments. The installed probe is automatically detected, which opens either the solution- or solid-state NMR branch of the library.

Solution-state NMR experiments

The library has been developed mainly for protein NMR, but it can be easily extended to other fields of applications. Currently, the library comprises NMR tools for sample quality control, resonance assignment, and the measurement of structural and dynamic NMR parameters. In particular, NMRlib contains most of the fast NMR experiments (SOFAST-HMQC, HET-SOFAST, BEST-HSQC, BEST-TROSY, HADAMAC, ...) developed during recent years at IBS. In addition, it also contains tools for pulse calibration, setup of composite pulse decoupling, and advanced data processing.
NMRlib is regularly updated with new developments. So, have a look back at this site in the future.

Latest developments in the solution-state NMR branch

09/2019 The BEST-TROSY HNCA, HNcoCA, and iHNCA experiments now contain options for CB decoupling during CA chemical shift editing using GOODCOP/BADCOP pulses.

Solid-state NMRlib experiments

Currently, more than 140 pulse sequences are implemented for homo- and heteronuclear experiment from 1D to 4D. The library comprises 1H-, 13C- and 15N-detected experiments for biomolecular resonance assignment (protein backbone and side chains, sugars), distance restraints (1H-1H, 13C-13C), molecular dynamics (relaxation, dipolar-coupling measurements, conformational exchange).
The library contains also an extensive set of calibration tools for transfer steps (cross-polarization ; homonuclear transfers such as BSH-CP, DREAM, RFDR ; INEPT etc).
Safety checks furthermore assist the user in experiment setup.

Installation of NMRlib

  •  Download the archive using the request form on this web page.
     Unzip the file on your spectrometer disk, or alternatively at an NFS mounting point if you want to share NMRlib between several spectrometers.
  •  Execute the setup python script ( from a shell terminal.
  •  You will be asked to update your "Manage Preference Directories".
  •  Restart the TopSpin software.
  •  From the TopSpin command line execute : edpy setNMRlib (to be executed on each spectrometer).
  •  To activiate the IBS tool buttons click on the arrow sign in the TopSpin tool bar as illustrated in the figure below :
Alternatively you can enter "nmrlib" in the Topspin command line.
Corresponding shell commands:

cd NMRlib

You can test the library on your protein by running a large set of experiment in 1D, 2D or 3D mode by clicking on "Spectro tests".


All pulse sequences and python scripts have been tested on Bruker Avance III HD spectrometers and TopSpin version 3.2 to 4.0 using Linux host computers. The NMRlib program is provided as is, and the authors of the program disclaim all liability whatsoever, and offer no warranty, express or implied, as to the damages, direct or indirect, that may result from downloading, use of the program and exploitation of the results thereof.

Rules for the use of NMRlib

For academic users, the use of the NMRlib software package is free of charge. Please fill in the form below to receive a link for the download of NMRlib.

Please acknowledge the use of NMRlib for you research by citing the following papers. For the solution-state NMR branch cite : A. Favier and B. Brutscher, J Biomol NMR 2019, 73:199-211. ; for the solid-state NMR branch cite : A. Vallet, A. Favier, B. Brutscher & P. Schanda, Magn. Reson. Discuss.,, in review, 2020. ;

For industrial users : please contact Rime Kerfah ( at NMRBio (link) for a quotation of the NMRlib licence.

Note concerning topspin4.1

The automatic probe type detection (solid or liquid) does not work yet for this topspin version. If you want to use the liquid library, please comment out the last 2 lines of the file :

#if cond_MAS== 1:
#    PROBE='solids'
Software name :
Your name (requested) :
Your organization (requested) :
Your email (requested) :
Licence (requested) :
I accept the conditions of use
Your comments / Votre commentaire :
Note :
  • A download link (valif for 24h)
  • Your address will not be disclosed to anyone
  • The data collected is used to verify your ability to obtain the software and to keep you informed of any changes (bugs, updates).
    These data are not communicated to third parties and you have the right to access, rectify or delete them by contacting Adrien Favier or rgpd[at]

NMRlib user locations, more than 100 labs