TopSpin Python Interface

Jython interpreter (based on Python 2.7 ) has been part of TopSpin as a standard component for scripting and application development for 20 years. The Jython scripts are executed in the same Java virtual machine that runs the TopSpin user interface. This offers numerous possibilities, but also comes with some limitations.

Why not combine the capabilities of TopSpin, as the standard software for processing of NMR spectra, with Python 3 scripts and harness the power of all available packages?

The new Python application programming interface of TopSpin allows users to access TopSpin from any Python 3.9+ environment and is an alternative to, but does not replace, the well-established TopSpin Jython interpreter.

New features

• Advanced data analysis
• Data mining
• Publication quality image generation

The following functions are available

• Reading/writing of parameters
• Reading of data vectors, peak lists, integration regions...
• Writing 1D and 2D data vectors
  
• Auxiliary functions such as NMR data search, data set display in TopSpin…
• Execution of any TopSpin command

Data access is currently limited to one- and two-dimensional spectra. You can either read entire data vectors, or selected parts such as individual rows in a "ser" file, or columns from a 2D spectrum.

During the development of the Python programming interfaces, special emphasis was placed on user-friendliness. Whenever possible, a familiar syntax is used. For example, handling parameters or sending commands to TopSpin use the same syntax as typing in TopSpin command line.  The interfaces used for data access are identical for Python and Jython. This allows the code to be shared for different use cases.

Availability

TopSpin 4.3 for Windows includes an out-of-the-box Python 3.10 environment with all packages installed. Documentation, sample scripts, and the Bruker Python packages are available on each platform.