Metadata-Version: 2.4
Name: mritk
Version: 0.2.0
Summary: MRI processing toolkit.
Author-email: Jørgen Riseth <jnriseth@gmail.com>, Henrik Finsberg <henriknf@simula.no>, Cécile Daversin Catty <cecile@simula.no>
License-Expression: MIT
Project-URL: Homepage, https://github.com/scientificcomputing/mri-toolkit.git
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tqdm
Requires-Dist: numpy
Requires-Dist: rich-argparse
Requires-Dist: nibabel
Requires-Dist: pandas
Requires-Dist: scipy
Requires-Dist: scikit-image
Requires-Dist: pydicom
Requires-Dist: dcm2niix
Provides-Extra: show
Requires-Dist: textual-image; extra == "show"
Requires-Dist: pillow; extra == "show"
Requires-Dist: matplotlib; extra == "show"
Provides-Extra: napari
Requires-Dist: napari[all]; extra == "napari"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Provides-Extra: pypi
Requires-Dist: build; extra == "pypi"
Provides-Extra: docs
Requires-Dist: sphinxcontrib-bibtex; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Requires-Dist: sphinx-codeautolink; extra == "docs"
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: jupytext; extra == "docs"
Requires-Dist: sphinx-togglebutton; extra == "docs"
Requires-Dist: sphinx-comments; extra == "docs"
Requires-Dist: sphinx-external-toc; extra == "docs"
Requires-Dist: linkify-it-py; extra == "docs"
Requires-Dist: sphinx-design; extra == "docs"
Requires-Dist: sphinx-book-theme; extra == "docs"
Requires-Dist: myst-nb; extra == "docs"
Requires-Dist: sphinx-multitoc-numbering; extra == "docs"
Requires-Dist: sphinxcontrib-mermaid; extra == "docs"
Provides-Extra: all
Requires-Dist: mritk[extra,napari,pypi,show,test]; extra == "all"
Dynamic: license-file

# MRI-Toolkit

`MRI-toolkit` provides a set of features dedicated to MRI data post-processing and analysis.

The implementation is inspired by [gMRI2FEM](https://github.com/jorgenriseth/gMRI2FEM), and some of the code is taken from that project. However, `MRI-toolkit` is designed to be more modular and extensible, with a focus on providing a user-friendly command-line interface (CLI) for common MRI processing tasks.

## Installation

```bash
pip install mritk
```

## Documentation

The documentation is available at [https://scientificcomputing.github.io/mri-toolkit/](https://scientificcomputing.github.io/mri-toolkit/). It includes detailed usage instructions, API references, and examples.


## Quick Start

To get started with `mri-toolkit`, you can use the command-line interface (CLI) to inspect and analyze your MRI data.

![readme](https://github.com/user-attachments/assets/83d4ff78-2ce3-4975-bec7-b05200e6212d)


## Features


- File Inspection: detailed NIfTI header analysis (affine, voxel size, shape).

- $T_1$ Mapping: Estimate $T_1$ relaxation times using Look-Locker or Mixed sequences, and seamlessly merge them into comprehensive Hybrid $T_1$ maps.

- $R_1$ Relaxation Rates: Convert $T_1$ maps into $R_1$ relaxation rate maps for linear scaling with tracer concentrations.

- Concentration Mapping: Calculate the spatial distribution of contrast agents (e.g., gadobutrol) utilizing pre- and post-contrast $T_1$ or $R_1$ maps.

- Statistics: Compute comprehensive statistics (volume, mean, median, std, percentiles) for MRI regions based on segmentation maps.

- Visualization:

    - Terminal: View orthogonal slices (Sagittal, Coronal, Axial) directly in your console.

    - Napari: Launch the Napari viewer for interactive 3D inspection.

- Data Management: Utilities to download datasets.

## Contributing
Contributions to `MRI-toolkit` are welcome! If you have an idea for a new feature, improvement, or bug fix, please open an issue or submit a pull request on GitHub. For more details on how to contribute, please see the [Contributing Guide](CONTRIBUTING.md).

## License
`MRI-toolkit` is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.
