Metadata-Version: 2.4
Name: ChameleonIQ
Version: 1.0.2
Summary: A tool for NEMA NU 2-2018 Image Quality analysis.
Author: Edwing Ulin-Briseno
Author-email: EdAlita <eyulibri@i3m.upv.es>
License-Expression: MIT AND (Apache-2.0 OR BSD-2-Clause)
Project-URL: Homepage, https://github.com/EdAlita/ChameleonIQ
Project-URL: Issues, https://github.com/EdAlita/ChameleonIQ/issues
Platform: unix
Platform: linux
Platform: osx
Platform: cygwin
Platform: win32
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 6 - Mature
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Healthcare Industry
Classifier: Natural Language :: English
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: numpy==2.2.6
Requires-Dist: scipy==1.16.0
Requires-Dist: scipy-stubs==1.16.0.2
Requires-Dist: nibabel==5.3.2
Requires-Dist: matplotlib==3.10.3
Requires-Dist: seaborn==0.13.2
Requires-Dist: pandas==2.3.1
Requires-Dist: yacs==0.1.8
Requires-Dist: opencv-python==4.12.0.88
Requires-Dist: pillow==11.3.0
Requires-Dist: reportlab==4.4.2
Requires-Dist: types-reportlab==4.4.1.20250602
Requires-Dist: SimpleITK==2.5.2
Requires-Dist: scikit-image==0.25.2
Requires-Dist: rich==14.2.0
Provides-Extra: dev
Requires-Dist: pytest==8.4.1; extra == "dev"
Requires-Dist: pytest-cov==6.2.1; extra == "dev"
Requires-Dist: mypy==1.16.1; extra == "dev"
Requires-Dist: mypy_extensions==1.1.0; extra == "dev"
Requires-Dist: flake8==7.3.0; extra == "dev"
Dynamic: license-file

<p align="center">
  <img
    alt="Logo Banner"
    src="https://raw.githubusercontent.com/EdAlita/nema_analysis_tool/main/data/banner.png"
  >
</p>

<p align="center">
  <a href="https://github.com/EdAlita/nema_analysis_tool/actions/workflows/tests.yml">
    <img alt="Tests" src="https://github.com/EdAlita/nema_analysis_tool/actions/workflows/tests.yml/badge.svg?branch=main">
  </a>
  <a href="https://github.com/psf/black">
    <img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg">
  </a>
  <a href="https://github.com/EdAlita/nema_analysis_tool/blob/main/LICENSE">
    <img alt="License: Apache-2.0" src="https://img.shields.io/badge/License-Apache_2.0-blue.svg">
  </a>
  <a>
    <img alt="Python" src="https://img.shields.io/badge/language-Python-blue?logo=python">
  </a>
  <a>
    <img alt="Git Download" src="https://img.shields.io/github/downloads/EdAlita/nema_analysis_tool/total">
  </a>
  <a>
    <img alt="Git Release" src="https://img.shields.io/github/v/release/EdAlita/ChameleonIQ">
  </a>
</p>


# ChameleonIQ: Nema-aware Image Quality Tool for Python

This project is a Python-based tool for the automated analysis of PET image quality based on the NEMA NU 2-2018 standard, specifically focusing on Section 7.4.1.

## Features

*   Calculates Percent Contrast (Q_H,j), Percent Background Variability (N_j), and Accuracy of Corrections (ΔC_lung,i).
*   Utilizes 3D Regions of Interest (ROIs) based on the NEMA Body Phantom.
*   Loads nii image data with user-defined dimensions and voxel spacing.
*   Automatic postions of ROIs on given centers

## Project Structure

```bash
nema-analysis-tool
├── data
├── documentation
├── src
│  ├── config
│  ├── nema_merge
│  ├── nema_quant
│  └── nema_quant_iter
└── tests
```

- [**Config**](src/config): configuration files to run the tool
- [**Data**](src/data): Data for testing and logos used for PDF reports
- [**Documentation**](src/nema_quant_iter): Documentation, wikis and how to install the tool
- [**nema_merge**](src/nema_merge): scripts for creating fusing of individuals runs
- [**nema_quant**](src/nema_quant): scripts for individuals test runs
- [**nema_quant_iter**](src/nema_quant_iter): scripts for a iteration based analysis

## How to get Started?
Read these:
- [**Installation instructions**](documentation/INSTALLATION.md)
- [**Usage instructions**](documentation/USAGE.md)
- [**How it works?**](documentation/HOW_IT_WORKS.md)

Additional information:
- [**What will change?**](documentation/CHANGELOG.md)

## License
This project is licensed under the Apache Lincese 2.0 - see the [LICENSE.md](LICENSE.txt) file for details.

[//]: # (- [Ignore label]&#40;documentation/ignore_label.md&#41;)
