Metadata-Version: 2.4
Name: pyasl-osipi
Version: 0.2.0
Summary: A composite, open-source Python library for processing human and preclinical ASL MRI data.
Author-email: "tongxin (elo) li, OSIPI" <li.tongxin.elo@gmail.com>
License: MIT License
Project-URL: Homepage, https://github.com/elooff/PyASL
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20
Requires-Dist: nibabel>=3.2.0
Requires-Dist: nipype>=1.5.1
Requires-Dist: scipy>=1.7.0
Requires-Dist: scikit-image>=0.19.0
Requires-Dist: pandas>=1.5.0
Requires-Dist: tensorflow>=2.10
Requires-Dist: matplotlib>=3.5
Requires-Dist: pyyaml>=6.0
Requires-Dist: fsspec>=2022.5.0
Requires-Dist: jinja2>=3.0
Requires-Dist: typing-extensions>=4.8.0
Provides-Extra: macos
Requires-Dist: tensorflow-macos>=2.12; extra == "macos"
Requires-Dist: tensorflow-metal>=1.0; extra == "macos"
Provides-Extra: cpu
Requires-Dist: tensorflow>=2.12; extra == "cpu"
Provides-Extra: gpu
Requires-Dist: tensorflow>=2.14; extra == "gpu"
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: black; extra == "dev"
Dynamic: license-file

# PyASL: Composite Python Library for ASL Image Processing

<p align="center">
  <img src="https://raw.githubusercontent.com/elooff/pyasl/master/docs/source/_static/gsoc_logo.svg" alt="Google Summer of Code" height="50"/>
  &nbsp;&nbsp;
  <img src="https://raw.githubusercontent.com/elooff/pyasl/master/docs/source/_static/osipi_logo.png" alt="OSIPI" height="70"/>
</p>

**PyASL** is an open-source Python library for processing arterial spin labeling (ASL) MRI data, developed under the [Google Summer of Code (GSoC)](https://summerofcode.withgoogle.com/) program for the [ISMRM OSIPI Task Force 2.2](https://osipi.ismrm.org/task-forces/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.

## Features

- 🧠 Read both human and preclinical ASL data format
- 📂 _(NEW!)_ Zero programming knowledge required for running a pipeline
- 🧩 _(NEW!)_ Mix & match preprocessing steps across different pipelines
- ➕ _(NEW!)_ Easy plug-in for adding new preprocessing steps
- 📘 [Tutorials and Documentation](https://github.com/elooff/pyasl/wiki/tutorials)

## 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_

For previous contributions of this project, please refer to [Yifan Shuai's work](https://github.com/Trico01/PyASL) for GSoC 2024.

## License

This project is licensed under the MIT License – see the [LICENSE](https://github.com/elooff/PyASL/blob/master/LICENSE) file for details.
