Skip to main content

Quantitative MRI processing

Project description

South Edinburgh Perfusion+ Analysis Library (SEPAL)

Please note: This library is also hosted in the OSIPI DCE-DSC-MRI_CodeCollection repository, where unit tests and perfusion code by other authors can also be found.

Python library for simulating and fitting DCE- and other quantitative MRI data. It permits arbitrary combinations of pulse sequence, pharmacokinetic model, water exchange model, etc. The code is a work-in-progress, has not been extensively tested and is not recommended or approved for clinical use.

Created 28 September 2020
@authors: Michael Thrippleton
@email: m.j.thrippleton@ed.ac.uk
@institution: University of Edinburgh, UK

Installation:

pip install sepal

Use:

Most functionality is demonstrated in Jupyter notebook format in ./demo

Functionality:

  • Enhancement-to-concentration conversion (assuming fast water exchange)
  • Fit tissue concentration using pharmacokinetic model
  • Fit signal enhancement using pharmacokinetic model
  • Pharmacokinetic models: steady-state, Patlak, extended Tofts, Tofts, 2CXM, 2CUM
  • Patlak fitting with multiple linear regression
  • AIFs: including patient-specific (measured), Parker, bi-exponential Parker
  • Fitting free AIF time delay parameter
  • Relaxivity models: linear
  • Signal models: spoiled gradient echo, inversion-recovery spin-echo
  • Water exchange models: FXL, NXL, NXL_be
  • T1 fitting using variable flip angle method, IR-SPGR, DESPOT1-HIFI and inversion recovery
  • T2(*) fitting for multi-TE acquisitions
  • MTR and MTSat calculation

Not yet implemented/limitations:

  • Additional pharmacokinetic models (add by inheriting from PkModel class)
  • Additional relaxivity models (add by inheriting from CRModel class)
  • Additional water exchange models, e.g. 3S2X, 2S1X (add by inheriting from WaterExModel class)
  • Additional signal models (add by inheriting from SignalModel class)
  • R2/R2* effects not included in fitting of enhancement curves (but is included for enhancement-to-concentration conversion)
  • Compartment-specific relaxivity parameters/models
  • Fitting water exchange parameters

Updates

Release 1.0.3 - Add exception handling for some zero/negative inputs.
Release 1.0.2 - Changed AIF interpolation method to linear to further reduce oscillations.
Release 1.0.1 - Changed AIF interpolation method to avoid oscillations. Added demo notebook on interpolation.

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

sepal-1.0.3.tar.gz (43.5 MB view hashes)

Uploaded Source

Built Distribution

sepal-1.0.3-py3-none-any.whl (38.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page