Skip to main content

Magnetic resonance experiment simulator and visualization tool.

Project description


PyPI Version Documentation Status


Magnetic resonance experiment simulator and visualization tool

MRSPRINT is a visual magnetic resonance simulator where you can simulate a magnetic resonance experiment - spectroscopy or imaging. Its main goal is to be an education tool that assists the student/staff to understand, interpret and explore magnetic resonance phenomena.

This tool is totally free (see license), but if you are making use of it, you need to cite us using both citations. This is very important for us.

  • Article: Coming soon!
  • Software: Coming soon!

If you are using this piece of software to generate images, gif’s, movies, etc., or using images available on this site, please, also reference us using those citations.

What can you see?

  • Precession: spins precessing in static magnetic field;
  • Resonance: resonance when a RF pulse is applied;
  • Contrast: T1, T2, and density of spins;
  • Field inhomogeneity: isochromates can be shown with their dispersion;
  • Gradient: magnetic field gradient in action, its intensity and effect over the frequency;
  • Evolution: over magnetization with intensity, frequency and phase and the pulse sequence;
  • FID: free induction decay, the signal;
  • Echo: spin or gradient echo (rephasing/dephasing).

Future planned features

  • K-space visualization;
  • Multi-nuclei samples/experiments;
  • T2* as sample parameter to easily setup field inhomogeneity;
  • Graphical sequence editor;
  • Chemical interactions;
  • View on coordinate laboratory system;
  • Flow (spins not fixed in positions).


Go to documentation on ReadTheDocs! It is available on Read The Docs in HTML, EPUB, and PDF.

Download binaries - click-and-run

Binaries are for those do not wish to install any Python things. We recommend them to the ones without any programming experience. Download from links below.

  • Portable Windows Binaries: coming soon!
  • Portable Linux Binaries: coming soon!
  • Portable Mac Binaries: coming soon!

Sou you can just download, decompress, click-and-run.

Installing from PyPI - stable, end-user

To install, do

$ pip install mrsprint

This will install all necessary dependencies then the code.

To run from terminal

$ mrsprint


  • NumPy: Numerical mathematical library;
  • SciPy: Scientific library;
  • NMRGlue: NMR processing library;
  • H5Py: Storing and managing data files;
  • PyQtGraph: Data visualization library;
  • PyQt/Pyside: Graphical framework.

Dependencies are automatically installed when using the method above.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mrsprint-1.2.2.tar.gz (10.2 MB view hashes)

Uploaded source

Built Distribution

mrsprint-1.2.2-py3-none-any.whl (286.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page