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, Georgiou
  • 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.2.1 - "Georgiou" AIF added to aifs module Release 1.1.1 - roi_measure exclude NaNs when calculating percentiles Release 1.1.0 - roi_measure modified to generate more ROI statistics 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.2.1.tar.gz (43.5 MB view details)

Uploaded Source

Built Distribution

sepal-1.2.1-py3-none-any.whl (39.3 kB view details)

Uploaded Python 3

File details

Details for the file sepal-1.2.1.tar.gz.

File metadata

  • Download URL: sepal-1.2.1.tar.gz
  • Upload date:
  • Size: 43.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for sepal-1.2.1.tar.gz
Algorithm Hash digest
SHA256 a69d7c24bb20b796507cb76eb6f0e62637bf8e98483ad25ad4a4bda97afc0ce8
MD5 2002d69b8440a99539227ac00e1c27d5
BLAKE2b-256 52f857b53a127cf2c2e2f84a34688b06c01317b7ee2d7d9b28aa302d5b15dbf5

See more details on using hashes here.

Provenance

The following attestation bundles were made for sepal-1.2.1.tar.gz:

Publisher: publish.yml on mjt320/SEPAL

Attestations:

File details

Details for the file sepal-1.2.1-py3-none-any.whl.

File metadata

  • Download URL: sepal-1.2.1-py3-none-any.whl
  • Upload date:
  • Size: 39.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for sepal-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b0467b476147719bfc099a450b93870cf50a524c9bc1a5c128c169a09432acfc
MD5 4d4a7a7237a86e5a02fdb3db8b9cd67a
BLAKE2b-256 6560fe919cf0354f0ee9d2691c30fafc988e1fece26e4b82fcbc679f9d06ddec

See more details on using hashes here.

Provenance

The following attestation bundles were made for sepal-1.2.1-py3-none-any.whl:

Publisher: publish.yml on mjt320/SEPAL

Attestations:

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