MRzero Core
The MRzero Core contains the core functionality of MRzero like MRI sequence building, simulation and reconstruction. MRzero Core does not force you to take any particular approach to e.g., reconstruction, as it targets easy integration in existing projects. Nevertheless, more tools can be added in the future if they helpful for the general application space.
🎉 1.0 release
Version 1.0 adds Pulseq 1.5 support and flips the sign convention of the simulated signal, so that it is now the complex conjugate of what previous versions returned. Reconstruction accordingly switches from
ffttoifft.See the FFT sign conventions page for details, and the CHANGELOG for the full list of changes. If anything else broke, please open an issue.
Usage
MRzero Core is written in Python, heavily relying on PyTorch for fast (GPU-) Tensor calculations. To improve performance, parts of the simulation are written in Rust and compiled for x86 Windows and Linux, other platforms are currently not supported.
Install with pip:
pip install MRzeroCore
The typical way of using it is like the following:
import MRzeroCore as mr0
Examples on how to use MR-zero can be found in the Playground.
Pulseq Integration
MRzero Core makes Pulseq simulation incredibly easy - simulate any .seq file in just one line:
import MRzeroCore as mr0
# Simulate any Pulseq file
seq = mr0.Sequence.import_file("your_sequence.seq")
signal = mr0.util.simulate(seq) # That's it!
Key Features:
- One-line simulation of any Pulseq .seq file
- PyPulseq integration - write sequences in Python, simulate with MR-zero
- Google Colab ready - 13+ ready-to-run examples
- MATLAB ↔ Python workflow - create in MATLAB Pulseq, simulate in Python
- No dependencies - fully self-contained Pulseq parser included
- Scanner-ready export - export MR-zero sequences as .seq files
Try it now:
Links
- Documentation: https://mrsources.github.io/MRzero-Core
- Examples: Playground
- PyPI: https://pypi.org/project/mrzerocore/
- Original MRzero Paper: https://arxiv.org/abs/2002.04265
Building from source
This assumes windows as host operating system. For building the python wheel, you need:
- the Rust toolchain: rustup
- the rust-python build tool tool: pip install maturin
- for Linux crosscompilation: docker
- to build the documentation: mdBook
Building for Windows
maturin build --interpreter python
Building for Linux
docker run --rm -v <path-to-repo>/MRzero-Core:/io ghcr.io/pyo3/maturin build
Building the documentation
Install newest (beta) version of mdBook:
cargo install --git https://github.com/rust-lang/mdBook.git mdbook
Run a live-preview server:
# in the root directory:
mdbook serve documentation
Official builds
The python wheels hosted by PyPI is built as described above. It is deployed as GitHub action (see pypi_publish.yml)
1 maintainer
Release files for mrzerocore 1.0.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mrzerocore-1.0.8.tar.gz | 75.9 MB | Details |
Built distributions (wheels)
Total release size:84.5 MB
Release files / mrzerocore-1.0.8.tar.gz
| Download URL | mrzerocore-1.0.8.tar.gz |
|---|---|
| Size | 75.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
309884a3f635758c11bf7cdcd39108c6a1fd312019b1d4f122be2e567fe8d3fa
|
|
BLAKE2b-256 checksum How to use checksums |
8594762d5ca698ee55fd9a7e405ef0c9bc3c787f4f560349f92e0014d8590272
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-win_amd64.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-win_amd64.whl |
|---|---|
| Size | 475.1 kB |
| Tags | CPython 3.7 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
483397df5d29030ce5d627d75e3a8b35932a9ed391a1dadef9970074822ce5f8
|
|
BLAKE2b-256 checksum How to use checksums |
44e0571679ae814c8d6de5e6f84471c18b946bc0b72406e4f7e258d637bba33c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-win32.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-win32.whl |
|---|---|
| Size | 458.2 kB |
| Tags | CPython 3.7 Windows x86-32 abi3 |
|
SHA-256 checksum How to use checksums |
1d6f68c9f649ab96f320efddce24945011b9f44bbd4a8d682568b1c5d9c75e7d
|
|
BLAKE2b-256 checksum How to use checksums |
513c45a41837e8feaa5ca6371b3786475b89f97b2387915019475cbd0a788a58
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-musllinux_1_2_x86_64.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 771.9 kB |
| Tags | CPython 3.7 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
712603dbb468a5f2c84e61e616cfe8023ff82bc0ea26f6d27adf01f393f71a88
|
|
BLAKE2b-256 checksum How to use checksums |
ffccfc48cfdcd1804c079eb7808df286a189b0ef04345a30950f664a24c36c4c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-musllinux_1_2_i686.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-musllinux_1_2_i686.whl |
|---|---|
| Size | 813.1 kB |
| Tags | CPython 3.7 Linux musl 1.2+ x86-32 abi3 |
|
SHA-256 checksum How to use checksums |
03178156a765d4b5bbfa2e4d3c56aed0ebe32406a4d0e3ae91014eaf2eb21a4e
|
|
BLAKE2b-256 checksum How to use checksums |
fb1970cd31411d5fcef5f06d3e72608a6fd4816f138e04bf28010c049667518d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-musllinux_1_2_armv7l.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-musllinux_1_2_armv7l.whl |
|---|---|
| Size | 823.1 kB |
| Tags | CPython 3.7 Linux musl 1.2+ ARMv7l abi3 |
|
SHA-256 checksum How to use checksums |
39332e1d292e0dbfa2104e89e0fafcf95555458f0710b24aae51a07ed8fb92bd
|
|
BLAKE2b-256 checksum How to use checksums |
adaf1fbb2ced8ea6e432a39d0fba07bd4ccad0e3f64f9e54de0140a6f475c553
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-musllinux_1_2_aarch64.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 716.4 kB |
| Tags | CPython 3.7 Linux musl 1.2+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
e4009c7382b92e22c544f120995577fcf9f7ccdf1c03e3995e4b016ad51de1f5
|
|
BLAKE2b-256 checksum How to use checksums |
ee963c37271ad10f19105fedfc9c73da494ae47e9adcc2cede112ad8de9ecaa4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 562.8 kB |
| Tags | CPython 3.7 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
87828deb3c52dc96074d4119f08fdd87a5264704143ee5fd743f574ef76b45b7
|
|
BLAKE2b-256 checksum How to use checksums |
4eab1704ae52f6252e6609d5e6122bee0065531613060bd05bacef16cdfe7215
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl |
|---|---|
| Size | 620.7 kB |
| Tags | CPython 3.7 Linux glibc 2.17+ IBM System/390x abi3 |
|
SHA-256 checksum How to use checksums |
846657d91e91f5332e05d05e2d01b866d1273aac7b56de4000a644c68e68c86a
|
|
BLAKE2b-256 checksum How to use checksums |
778b62fa0ec1b842074bdb38e833cef93980b24de473f67e33f318ade2ab2ae6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl |
|---|---|
| Size | 672.5 kB |
| Tags | CPython 3.7 Linux glibc 2.17+ PowerPC 64-le abi3 |
|
SHA-256 checksum How to use checksums |
7ca3df811aed340d3090b1da3a5896b1d526e44eee8ad01d3bbd50ca660df5e4
|
|
BLAKE2b-256 checksum How to use checksums |
609366e1db4051e3879d21f0b8e4af0598361ee7599f5725555f1f7f52a7e140
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl |
|---|---|
| Size | 545.3 kB |
| Tags | CPython 3.7 Linux glibc 2.17+ ARMv7l abi3 |
|
SHA-256 checksum How to use checksums |
b6bf7f6927ffe3a120268b5370b8918cf234fac7030e83003b0f282984d7efde
|
|
BLAKE2b-256 checksum How to use checksums |
f2609fce5f67d85d8c47450772cd7c3ce0126d5e171443577cbe19c272dc842c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 538.2 kB |
| Tags | CPython 3.7 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
ee0e6e747293e0a03446881791775259d95762e9a30489fd72399d4037107117
|
|
BLAKE2b-256 checksum How to use checksums |
b7efd9726344e56dd38afde57cc751b38a90fa84563bc884c837dc446b477402
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-manylinux_2_5_i686.manylinux1_i686.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-manylinux_2_5_i686.manylinux1_i686.whl |
|---|---|
| Size | 606.4 kB |
| Tags | CPython 3.7 Linux glibc 2.5+ x86-32 abi3 |
|
SHA-256 checksum How to use checksums |
d0a55f6cf01bbc7157d31b89998d4acd13a0119a6d0a4d3d641bf834cfce6f4c
|
|
BLAKE2b-256 checksum How to use checksums |
8b0650b558ca18729f63cb196426c8906289cfda7b19ecb07732cc93ecb548e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-macosx_11_0_arm64.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 514.7 kB |
| Tags | CPython 3.7 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
422180b2affde47318be5918a1fc21bda957f993778e0e8eecc8739f69b69024
|
|
BLAKE2b-256 checksum How to use checksums |
5626e6d66500823821652e06e52faeb0976d24630475256dfb73d5a3e6d8652d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mrzerocore-1.0.8-cp37-abi3-macosx_10_12_x86_64.whl
| Download URL | mrzerocore-1.0.8-cp37-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 529.0 kB |
| Tags | CPython 3.7 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
37d4d616c3e8c4cdbb205e753b27c9667eb29d5cfd1c983666db38c0081218a3
|
|
BLAKE2b-256 checksum How to use checksums |
fc87234048e119549f172945ea8170c9ef93ef3812a66577f4c0fdc068453fe9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
