Skip to content

Frequently Asked Questions#

Getting Started#

How do I install the TQT Nuclei software?#

Register at the TerraQuantTech LLC web portal, accept the terms of service, and request a trial or purchase a full license. After obtaining the license file (.tl), download the installer for your operating system (Windows or macOS) and follow the installation instructions.

How do I set the device to the correct operating temperature?#

When you first power on the device, allow 1-2 hours for the magnet to reach its operating temperature. Monitor the temperature in the HOME tab, where the current temperature (T_cur) and the set temperature (T_set) are displayed. A green signal indicates the system is ready, while a flashing yellow signal means it is still heating up.

What should I do if I see a red temperature signal?#

A red signal indicates overheating or an error in the temperature reading circuit. Check the device for any potential issues and ensure it is in a well-ventilated area. If the problem persists, contact support.

How do I start an experiment?#

Once the system is configured, go to the ACQUISITION page, select an experiment preset (e.g., Hahn-Echo or CPMG), and click START. The results will be displayed in the main window, and if the "Save" or "Save as new experiment" options are checked, the data will also appear in the DATA BROWSER.

What does the "Experiment Data Preview Toggle" do?#

The Experiment Data Preview Toggle lets you customize how data is displayed in any plot component. You can adjust the plot theme, rename the graph title and axes, modify the legend, assign colors to signal lines, and change the data point rendering style (scatter, line, histogram).

Can I create custom experiments in the app?#

Yes, using the SEQUENCE page. You have two options:

  • Python scripting: Write your experiment in Python using an integrated editor with LSP support.
  • Graphic nodes mode: Build experiments visually by arranging nodes such as Pulse, Silence, ADC, and more.

How do I load and review previous experiments?#

Go to the DATA BROWSER page. On the left, you will see a file tree with all your experiments. Select the desired experiment to view its details, preview the data, load it, or export it. A table shows metadata and experimental settings, including pulse durations, amplifications, and phases.

What types of experiments are available as presets?#

The app offers several pre-configured experiment presets, including CPMG, FID (Free Induction Decay), T1 (Inversion Recovery), and Hahn-Echo. Select them from the ACQUISITION page and press START.

Can I create custom user interfaces within the app?#

Yes, on the CUSTOM PAGE you can design your own UI using HTML layouts and Python logic. In Edit Mode, toggle between the Layout (structure) and Code (functionality) tabs. Switching from Edit to View Mode may take a few seconds to render large pages.

Where can I find help or report issues?#

The HELP page provides two main options:

There is also a quick information panel summarizing key software and hardware details.

Advanced#

These questions target users who already have experience working with NMR spectrometers and relaxometers.

How do I manually adjust the dead time (ring-down time) for my resonant circuit?#

Go to the HOME page and select the DEAD TIME tab. Fine-tune the dead time value to define the period immediately after the excitation pulse during which the receiver is inactive, allowing you to measure the signal cleanly without hardware ringing interference.

Can I adjust the phase manually for each pulse in an experiment?#

Yes, in the PHASE tab of the HOME page. This is especially useful for advanced pulse sequences where precise phase control is critical for signal acquisition.

How do I optimize my radio frequency (RF) pulse length for my sample?#

Navigate to the DURATION tab on the HOME page. Set the RF pulse duration to ensure the correct flip angle for your sample. Typically, you will perform a nutation experiment to determine the optimal pulse length for your specific conditions.

How can I integrate custom external hardware (e.g., temperature controllers or gradient coils)?#

TQT Nuclei allows custom hardware integration via the Settings page. Use the provided hardware API to interface with temperature control units, gradient coils, and more. Make sure your hardware is supported by the software's I/O system.

How do I synchronize multiple relaxation experiments on a single sample?#

Use the SCHEDULER page to automate the sequence of multiple relaxation experiments. Set up a timeline where T1, T2, and other experiments (e.g., CPMG or FID) run sequentially or in parallel, with fine control over timing and repetition.

Can I export raw NMR data for external processing?#

Yes, on the DATA BROWSER page you can export raw data in several formats including CSV. Select the experiment, click the export button, and choose your format. You can also download raw data directly from the plot via the Experiment Data Preview Toggle.

How can I add my own NMR pulse sequences?#

On the SEQUENCE page, either write a custom pulse sequence in Python or build one using the graphic node interface. The Program Start, Pulse, Silence, and ADC nodes let you define your sequence visually. Use For loops and Math nodes for complex logic and calculations.

What is the purpose of the decimation parameter in T2 CPMG experiments?#

The decimation parameter lets you skip a certain number of p180 pulses in the echo train. This extends the effective T2 measurement range by sampling later echoes, especially for samples with long T2 relaxation times. Decimation reduces data acquisition time without sacrificing accuracy in longer relaxation measurements.

How can I fine-tune my pulse sequence timing using the graphic node interface?#

In the SEQUENCE page's graphic node mode, click on each Pulse or Silence node to adjust the duration, frequency, and phase. The visual timeline at the top helps you verify event timing. Insert Math nodes to dynamically adjust time delays or pulse durations based on calculated values.

How do I troubleshoot an unstable baseline in my experiments?#

Check the following:

  • Ensure the magnet temperature has stabilized (green indicator).
  • Verify that the phase and pulse durations are optimized for your sample.
  • Check for proper decoupling or saturation in multi-dimensional experiments.
  • Use the HELP page to consult the documentation or open a support ticket if issues persist.