Skip to content

About

MRI console application based on spectrum-instrumentation measurement cards and pulse sequences from pypulseq. Read more in the docs!

Topics

Resources

Stars

30 stars

Watchers

5 watching

Forks

Repository files navigation

Nexus Console

DOI Python License Docs Static Tests Pytest Coverage

An open-source Python console for versatile low-field MRI acquisition

Nexus replaces the proprietary spectrometer of an MRI system with two commercial PCIe measurement cards from Spectrum Instrumentation, an arbitrary waveform generator (transmit) and a digitizer (receive), operated by open-source Python software. The console is designed for pulse sequences that are defined in the open Pulseq format. Using PyPulseq, they can be built directly within the Nexus framework or loaded from a valid .seq file. From the Pulseq sequence, the corresponding RF and gradient waveforms are calculated and streamed to the transmit card without the need for a vendor-specific sequence compiler. Received signals are demodulated, phase-corrected and decimated on the host and exported in the ISMRMRD format for reconstruction with any compatible framework. The console was developed and validated on a ~50 mT low-field MRI system presented here. It is not tied to a specific field strength or hardware setup: amplifiers, coils and system limits are described in a configuration file.

Documentation

The documentation includes a quick start guide, system guide, examples, API reference and a list of related references.

To build the documentation locally, install the docs-mkdocs extra and start the development server:

pip install -e ".[docs-mkdocs]"
mkdocs serve --watch src

Installation

Requires Python ≥ 3.13 and the Spectrum Instrumentation driver for the measurement cards.

pip install nexus-console

See the Installation for the development installation and the device configuration.

Repository structure

Path Contents
src/console/ Python package: card control, sequence unrolling, data interfaces, processing, built-in sequences
examples/ Acquisition scripts and a reference device configuration
tests/ Test suite
docs/ Documentation sources (MkDocs)

Citation

Tip

If Nexus contributes to your research, please cite our paper:

Schote D, Silemek B, O'Reilly T, Seifert F, Assmy JL, Kolbitsch C, Webb AG, Winter L. Nexus: A versatile console for advanced low-field MRI. Magn Reson Med. 2025;93(5):2224–2238. doi:10.1002/mrm.30406

BibTeX
@article{schote2025nexus,
  title   = {Nexus: A versatile console for advanced low-field {MRI}},
  author  = {Schote, David and Silemek, Berk and O'Reilly, Thomas and Seifert, Frank and
             Assmy, Jan-Lukas and Kolbitsch, Christoph and Webb, Andrew G. and Winter, Lukas},
  journal = {Magnetic Resonance in Medicine},
  volume  = {93},
  number  = {5},
  pages   = {2224--2238},
  year    = {2025},
  doi     = {10.1002/mrm.30406}
}

Acknowledgments

This work is part of the Metrology for Artificial Intelligence for Medicine (M4AIM) project, funded by the Federal Ministry of Economic Affairs and Climate Action (BMWK) as part of the QI-Digital initiative. The projects 21NRM05 STASIS and 22HLT02 A4IM have received funding from the European Partnership on Metrology, cofinanced by the European Union's Horizon Europe Research and Innovation Program and by the Participating States. Partial support is provided by a European Research Council Advanced Grant (PASMAR 101021218). This work is supported by the Open Source Imaging Initiative (OSI²).

About

MRI console application based on spectrum-instrumentation measurement cards and pulse sequences from pypulseq. Read more in the docs!

Topics

Resources

Stars

30 stars

Watchers

5 watching

Forks

Used by

Contributors

Languages