Back to a list of spectrometers






The KovriginNMR software suite has two major components:

Variable-Temperature control

The VT control tools of KovriginNMR help the NMR user safely operate Bruker variable-temperature unit to reach accurately calibrated temperatures in the full temperature range of the probe. A casual NMR user will appreciate a single-click functionality while an expert NMR users will enjoy automation of time-consuming tasks such as finely resolved temperature series or kinetic series at different sample temperatures.

The distinctive features of VT control through KovriginNMR are:

  1. The temperature setting is accurate in the entire range avalaible on the current system (for example , -150C to +150C for probes with liquid N2 chillers, -58C to + 150C for BCU-II chiller). The temperature calibrations were performed upon KovriginNMR setup and, generally, accurate within 0.2-0.5 C.

  2. The process of changing temperature is completely controlled by KovriginNMR (bypassing a standard EDTE interface) to make the ramps appropriately slow and safe for the probe and the sample.

  3. The software obeys the temperature limits of spinners and solvents to eliminate accidents, for example, when a solvent boiling point is exceeded. The KovriginNMR automatically adjusts VT gas flow according to the current temperature of the probe and controls the cooling mode for the automatic chillers (BCU-I and BCU-II).

    The only manual operation that remains a responsibility of the NMR user is to open the shimstack gas valve when target sample temperature will be outside of 0C to 80C range.

IMPORTANT: The KovriginNMR sofware is intended for the NMR users who took the Variable-Temperature Control training with Dr. Kovrigin.


Multi-sample operation

KovriginNMR includes a set of light-weight programs helping the expert NMR user with recording multiple experiments on multiple samples in unattended mode (aka overnight). Any set of experiments or Topspin command sequence may be executed for each chosen sample and they may differ from sample to sample as needed.






Getting Started

Variable-Temperature Control



Back to Top



Step 1: Set up KovriginNMR in the user account

To enable KovriginNMR software suite in your Topspin, please, follow these steps:

  1. Display a 1D (or 2D) experiment

  2. Right click in the empty space next to the toolbar picture buttons:

  3. Choose User-Defined Buttons

  4. Choose 1D-nD
  5. Type in the following text:

    1. Name: KovriginNMR, in Command column: kovriginnmr_launch_fbar, in Tool Tip Text: Show KovriginNMR Standard toolbar

    2. Name: KovriginNMR Expert, in Command column: kovriginnmr_expert_launch_fbar, in Tool Tip Text: Show KovriginNMR Expert toolbar

    3. Make sure Disable display of user-defined buttons is unchecked

    4. Click OK

    You should see two new buttons appear next to the picture toolbar: KovriginNMR and KovriginNMR Expert

  6. Clicking KovriginNMR  button displays the standard toolbar. This toolbar combines the most common tasks the NMR spectroscopists needs for VT operation.

  7. To exit the KovriginNMR toolbar, click Back to Acquire. To proceed with the VT experiment, see Prepare for your VT experiment

  8. Optional: The KovriginNMR Expert button brings up an extended toolbar designed for an expert NMR user (to be described in a separate document)



Back to Top

Step 2: Prepare desktop for running KovriginNMR

KovriginNMR is a set of Python programs that run inside Topspin. When they are running they assume control of Topspin, yet Topspin still allows to issue additional commands on top of KovriginNMR, which may confuse Python code operation and lead to unpredictable results. Therefore, KovriginNMR is used with two Topspin windows: primary (for KovriginNMR) and secondary (for dataset browsing, analysis, and anything else, like edte).

To open the second Topspin window, click [New Topspin] button.

Arrange primary Topspin to left of the screen and secondary Topspin to the right:



Back to Top


Prepare for your VT experiment

Before starting your variable temperature work, you need to check several settings of the Variable Temperature Unit of your instrument:

  1. Type edte on Topspin command line to display Bruker Temperature Control Suite

  2. Go to Configuration tab

  3. Make a selection of temperature units that you prefer to use in your work.  This setting only affects the display of temperature on the bottom of Topspin screen. Temperature units for KovriginNMR will be set separately.

  4. Navigate to Correction tab and make sure the internal temperature correction in this tab is disabled. Topspin will display a direct reading from VTU in the Probe Temperature section of the status bar.

    The KovriginNMR suite uses its own temperature correction independent of the Bruker Temperature Control Suite. If the correction in the Correction tab remains enabled, it does not affect KovriginNMR operation but the Probe Tempeature display will be confusing for the user. Therefore, we recommend to disable temperature correction in this tab.


Back to Top


Change probe temperature to the desired experimental temperature

To change the Variable Temperature Unit (VTU) to the temperature required for you NMR experiment, do the following:

  1. Insert your sample in the spectrometer

  2. Tune, lock, shim and acquire a test 1D to verify that spectrometer is functional.

  3. Click Setup button in the primary Topspin window to bring up the dialog for entering spinner type and your solvent.

    Type in the spinner and solvent names that you are using and click OK. Solvents known to KovriginNMR are listed on the right. The chosen settings will be remembered till you change them (in this or other dialogs).

    NOTE: 'POM' is a usual blue spinner (most familiar for all users).

  4. Create a new experiment (EXPNO) for the data acquired at a new temperature and display it in primary Topspin window. From this point, KovriginNMR will be operating in this EXPNO. You must not change the EXPNO that is displayed in the primary Topspin! (You may display whatever in the secondary Topspin at any time).

  5. Click KovriginNMR button and Ramp to T. The dialog is displayed:

  6. Choose your temperature unit and target temperature

  7. Spinner type and the solvent are inherited from Setup or a previous ramp.

  8. Stabilized and tuned? question:
    The Variable-Temperature Unit (VTU) needs to be "tuned" after arrival to a new temperature. The VTU needs to know how cold the VT gas is at the corresponding VT gas flow to be able to keep the temperature stable.

Once you click OK, the KovriginNMR begins a stepwise temperature ramp to your target range. Software takes 5-degree steps and waits for the sample temperature to catch up before incrementing next. This gentle ramping mode preserves integrity of the expensive glass components of the probe.

A small window indicating that VTU is in operation pops up (this is automatic response for the VTU, not part of KovriginNMR)

You may click OK or just ignore it. It will be automatically dismissed by the next message window.


To help you see the same information that you normally see in the EDTE window, click [Show Status] button in the toolbar. The resulting window displays all parameters of the Variable Temperature Unit.

Important to note that the Show Status window lists both the direct (uncorrected) readings/settings of the VTU and recalculated corrected K or C values of the sample temperature, for user convenience. The direct readings called K VTU and C VTU are the same as the number shown on the Probe Temperature window of the Topspin status bar:



You may follow the progress of the temperature ramp by clicking Show Report button on the KovriginNMR toolbar.

This action displays an HTML document Temperature_ramp_log.html that is a log of the KovriginNMR operation. This document is saved in your dataset EXPNO and is continually updated so you may refresh the browser window to view the newest messages.


Sometimes, when you moved very far from the range where VTU was last self-tuned, the warning from VTU may pop up:

If your response to Stabilized and tuned? was 'no', it is safe to click Close and ignore this message because the KovriginNMR will self-tune at the end of the ramp. If you said 'yes', you will have to repeat Ramp to T with Stabilized and tuned? set to 'no' and the same target temperature. The system will not change temperature but trigger the self-tuning routine of the VTU.

When temperature ramp is finished and the spectrometer is ready for the NMR experiment, KovriginNMR displays a message:

KovriginNMR also updates the HTML log with the final message: "Temperature ramp is complete. VTU is stable."

At this point, you may proceed with your NMR experiment. You may click Back to Acquire to exit KovriginNMR or use the secondary Topspin window for your work and keep KovriginNMR open in the primary window.




Back to Top


Stopping (aborting) temperature ramp

At any point in the temperature ramp, you may stop KovriginNMR by clicking Stop KovriginNMR.

You will see a message:

The software quits in a short while. The exit is not instantaneous because KovriginNMR gives commands to VTU and waits for them to finish. If the request to stop came while VTU is busy, there will be a delay. One example is when self-tune routine has started as indicated by a message "Starting self-tuning routine." in the HTML log. This may also be observed by looking at the probe temperature display in the Topspin status bar: the Self tune and Reg. State symbols are both dark-violet rectangles:

KovriginNMR quits automatically after self-tune is complete with this message:

If KovriginNMR was aborted, the VTU stays at the currently acquired temperature. To move from this temperature, use Ramp to T again.

Back to Top


Finishing your VT work

When acquisition of your NMR data is completed, you must ramp spectrometer back to room temperature and switch the sample the CDCl3 standard. The KovriginNMR automates this task with End Work button that displays a dialog explaining that we are about to ramp temperature to 25C, stabilize and turn off the VTU. In addition, as required by the standard operating procedure, we will eject the sample, insert the standard from position 1 and lock on a standard. Setting 'yes' will enable this automatically, 'no' - will require user to manually switch to the standard sample after they are completely done with their experimentation.

The progress of this end-of-work ramp is logged in the html document 'Return_to_RT_log.html' saved in the current EXPNO. The document is continually updated, so you may refresh the internet browser window to see the progress of the return ramp. For example:

Double clicking on 'Return_to_RT_log.html' launches internet browser with display of the ramp log

Once the system arrived at 298K, it resets the parameters of gas flow to match the commonly used POM spinner and self-tunes the VTU. This final step is also logged in 'Final_stabilization_at_RT_log.html'


Upon completion KovriginNMR automatically changes the sample for the position of the standard sample (usually, 1) and locks (usually, CDCl3).

Finally, the End Work procedure turns off the VTU and exits with the message:

At this stage you may leave the spectrometer to the next user.


IMPORTANT DISCLAIMER: The user must monitor progress of the automated procedure and intervene if anything goes wrong. In other words, the goal of KovriginNMR automation is to relieve the user from a need to type too many commands but not from making final determination whether the system operates as expected.









Back to Top


Multi-sample operation tools






Back to Top