Metadata-Version: 2.4
Name: niimetric
Version: 0.1.0
Summary: Evaluate image quality metrics (SSIM, MAE, LPIPS, PSNR) for NIfTI images
Author-email: Your Name <your.email@example.com>
License: MIT
Project-URL: Homepage, https://github.com/yourusername/niimetric
Project-URL: Repository, https://github.com/yourusername/niimetric
Keywords: nifti,mri,image-quality,ssim,psnr,lpips,mae
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nibabel>=4.0.0
Requires-Dist: numpy>=1.20.0
Requires-Dist: scikit-image>=0.19.0
Requires-Dist: torch>=1.9.0
Requires-Dist: lpips>=0.1.4
Dynamic: license-file

# NiiMetric

A Python CLI tool for evaluating image quality metrics between NIfTI (.nii/.nii.gz) images.

## Features

- **SSIM** - Structural Similarity Index
- **PSNR** - Peak Signal-to-Noise Ratio
- **MAE** - Mean Absolute Error
- **LPIPS** - Learned Perceptual Image Patch Similarity
- **Auto-cropping** - Automatically crops to brain region based on reference image
- **CSV output** - Save results to CSV file

## Installation

```bash
pip install niimetric
```

## Usage

```bash
# Single metric
niimetric -a reference.nii.gz -b image1.nii.gz --ssim -o output.csv
niimetric -a reference.nii.gz -b image1.nii.gz --psnr -o output.csv
niimetric -a reference.nii.gz -b image1.nii.gz --mae -o output.csv
niimetric -a reference.nii.gz -b image1.nii.gz --lpips -o output.csv

# All metrics
niimetric -a reference.nii.gz -b image1.nii.gz --all -o output.csv
```

## Arguments

| Argument | Description |
|----------|-------------|
| `-a, --reference` | Reference NIfTI image (used for cropping boundaries) |
| `-b, --image` | Comparison NIfTI image |
| `-o, --output` | Output CSV file path |
| `--ssim` | Calculate SSIM |
| `--psnr` | Calculate PSNR |
| `--mae` | Calculate MAE |
| `--lpips` | Calculate LPIPS |
| `--all` | Calculate all metrics |

## License

MIT
