Metadata-Version: 2.3
Name: asltk
Version: 0.5.0
Summary: A quick to use library to process images for MRI Arterial Spin Labeling imaging protocols.
License: MIT
Author: Antonio Senra Filho
Author-email: acsenrafilho@alumni.usp.br
Requires-Python: >=3.9,<4.0
Classifier: Intended Audience :: Healthcare Industry
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Image Processing
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Requires-Dist: SimpleITK (>=2.4.0,<3.0.0)
Requires-Dist: dill (>=0.3.9,<0.4.0)
Requires-Dist: numpy (>=1.22.4,<2.0.0)
Requires-Dist: pybids (>=0.17.2,<0.18.0)
Requires-Dist: rich (>=13.8.1,<14.0.0)
Requires-Dist: scipy (>=1.13.1,<2.0.0)
Project-URL: Code, https://github.com/LOAMRI/asltk
Project-URL: Code Issues, https://github.com/LOAMRI/asltk/issues
Project-URL: Documentation, https://asltk.readthedocs.io/en/latest
Description-Content-Type: text/markdown

<img src="https://raw.githubusercontent.com/LOAMRI/asltk/refs/heads/develop/docs/assets/asltk-logo.png" width=200>

[![Documentation Stable](https://readthedocs.org/projects/asltk/badge/?version=main)](https://asltk.readthedocs.io/en/main/?badge=main)
[![codecov](https://codecov.io/gh/LOAMRI/asltk/graph/badge.svg?token=1W8GQ7SLU9)](https://codecov.io/gh/LOAMRI/asltk)
[![CI_main](https://github.com/LOAMRI/asltk/actions/workflows/ci_main.yaml/badge.svg)](https://github.com/LOAMRI/asltk/actions/workflows/ci_main.yaml)
[![CI_develop](https://github.com/LOAMRI/asltk/actions/workflows/ci_develop.yaml/badge.svg)](https://github.com/LOAMRI/asltk/actions/workflows/ci_develop.yaml)
![Python Versions](https://img.shields.io/badge/python-3.9%20|+-blue)
![PyPI downloads](https://img.shields.io/pypi/dm/asltk)
![Contributors](https://img.shields.io/github/contributors/LOAMRI/asltk)
[![GitHub issues](https://img.shields.io/github/issues-raw/LOAMRI/asltk.svg?maxAge=2592000)]()
[![GitHub Sponsor](https://img.shields.io/badge/Sponsor-❤️%20acsenrafilho-orange?logo=github)](https://github.com/sponsors/acsenrafilho)

# Arterial Spin Labeling Toolkit (asltk)

Welcome to the ASL toolkit!

This library was designed to assist users in processing Arterial Spin Labeling (ASL) MRI images, from basic imaging protocols to the state-of-the-art models provided in the scientific literature.

The major objective of this project is to give an open-source alternative to researchers in the MRI field. A profound knowledge of computing and data modelling is not a prior demand. It is expected that a simple set of Python commands can be helpful in fast prototyping an ASL experiment or even collecting simple quantitative ASL-based information.

Please read the [full documentation](https://asltk.readthedocs.io/en/main/) to get more details about the usage, implementation and updates in the `asltk` library. 

Also, feel free to contribute directly to the project! Check it out the [issues](https://github.com/LOAMRI/asltk/issues) at the repository and get in touch to the developers of the project. 


## How to install

A quick to use install is via `pip`, as follows:

> [!NOTE]
> The installation requires Python 3.9 or higher

```bash
pip install asltk
```

## Special thanks for all the contributors

Thank you all the special people that invested their time and knowledge to improve this project. 👏

![Contributors](https://contrib.rocks/image?repo=LOAMRI/asltk)

## Citation

We appreciate if one or more of the following references can be added in your projects due to the usage of `asltk` outcomes.

* Paper 1

