PyASL: Composite Python Library for ASL Image Processingο
PyASL is an open-source Python library for processing arterial spin labeling (ASL) MRI data, developed under the Google Summer of Code (GSoC) program for the ISMRM OSIPI Task Force 2.2.
It integrates multiple community-validated ASL tools, originally in MATLAB, and supports both human and preclinical pipelines. PyASL includes modules for ASL-MRICloud, ASLtbx, DL-ASL, Oxford ASL, preclinical multi-TI PASL, and preclinical pCASL, harmonized with ASL-BIDS input format.
Linksο
π¦ PyPI: https://pypi.org/project/pyasl-osipi/
π§βπ» GitHub: https://github.com/OSIPI/TF2.2_OSIPI-ASL-toolbox/tree/main/PyASL
Citationο
This library is part of the ISMRM 2025 submission: ISMRM Open Science Initiative for Perfusion Imaging (OSIPI): Composite Python Library for ASL Image Processing
Licenseο
Licensed under the MIT License. See the LICENSE file for details.
Contents
- Getting started
- How to use
- Human Data Processing
- π Expected raw layout
- βοΈ Minimal acquisition JSON
- π Run conversion / validation
- ASLtbx (human, single-delay)
- MRICloud (human, single- or multi-delay)
- DeepASL / DLASL (denoising)
- Oxford ASL (FSL oxford_asl)
- Preclinical: single-delay pCASL
- Preclinical: multi-TI PASL (absolute CBF via T1 fit)
- βCustomβ pipeline (advanced power-user)
- Running the pipelines
- JSON Parameters
- Modules
- Coregister (SPM / ASLtbx)
- Realign (SPM)
- Smooth (SPM)
- ResetOrientation
- CreateMask
- PerfusionQuantify (ASLtbx-style)
- DLASLBuildMask
- DLASLDenoiseCBF
- MRICloudReadMPR
- MRICloudRescale
- MRICloudCalculateDiffmap
- MRICloudCalculateM0
- MRICloudCalculateCBF
- MRICloudMultidelayCalculateM0
- MRICloudMultidelayCalculateCBFATT
- MRICloudCoregMPR
- MRICloudT1ROICBFAverage
- OxfordASLRun
- OxfordASLSplitM0
- NIfTILoader (Preclinical)
- BrukerLoader (Preclinical)
- ControlLabelSplit (Preclinical)
- SteadyStateTrim (Preclinical)
- DiffImage (Preclinical)
- ComputeM0 (Preclinical)
- CBFRelative (Preclinical)
- BrainMask (Preclinical)
- SlicePLDAdjust (Preclinical)
- AbsCBF_T1Fit (Preclinical)
- MotionCheck (Preclinical)
- SaveOutputs (Preclinical)
- Pipelines