qmrust - qmrust

qmrust is a native-Rust toolkit for quantitative MRI. Point it at a BIDS dataset and it fits qMRI models — inversion-recovery T1, multi-echo T2, MTR, MTsat, qMT-SPGR — as a fast command-line tool or directly in your browser via WebAssembly, with identical numbers either way.

qmrust fit --bids-dir ds-mydata --config recipes/bids/irt1_config.yaml \
  --output-dir out

New here? Getting started builds the CLI and runs your first fit. Curious first? The playground fits real data in this page, in your browser.

Methods¶

T1 Relaxometry¶

Inversion Recovery

Fits the longitudinal relaxation time T1 from a series of inversion-recovery images acquired at different inversion times.

IRT1 · T1map

Variable Flip Angle

Fits the longitudinal relaxation time T1 from spoiled gradient-echo images acquired at two or more excitation flip angles and a single repetition time.

VFA · T1map, M0map

T2 Relaxometry¶

Monoexp T2

Fits the transverse relaxation time T2 from a multi-echo spin-echo series as a mono-exponential decay with a free amplitude.

MESE · T2map, M0map

Field Mapping¶

Actual Flip Angle B1+

Maps the transmit (B1+) field from a single spoiled gradient-echo sequence that interleaves two excitation repetition times at one nominal flip angle.

TB1AFI · TB1map

Double Angle B1+

Maps the transmit (B1+) field from two spoiled gradient-echo volumes acquired at flip angles alpha and twice alpha.

TB1DAM · TB1map

Magnetization Transfer¶

Semi-quantitative MT¶

MT Ratio

Computes the magnetization transfer ratio from two images: one acquired with an off-resonance saturation pulse and one without.

MTR · MTRmap

MT Saturation

Derives the MT saturation parameter from three spoiled gradient-echo volumes — MT-weighted, PD-weighted and T1-weighted.

MTS · MTsat, T1map, MTRmap

Quantitative MT¶

qMT-SPGR

Two-pool quantitative magnetization transfer from a spoiled gradient-echo sequence with off-resonance saturation sampled across a grid of saturation flip angles and frequency offsets.

QMTSPGR · Fmap, kRmap, R1Fmap, R1Rmap, T2Fmap, T2Rmap

Guides¶

Getting started — build the CLI, run a fit, read the outputs.
BIDS — how collections, sidecars, auxiliary maps and masks are resolved.
Fitting without BIDS — 4D NIfTI and qMRLab .mat inputs.
Simulation — forward signals, sim→fit round-trips, sensitivity.
Browser & wasm — the same core, compiled to WebAssembly.

Contributing¶

qmrust is a functional core with an imperative shell: the numerical models are pure Rust and run unchanged natively and in wasm. See Architecture and Adding a model.