Metadata-Version: 2.4
Name: deepprostate
Version: 1.5.0
Summary: AI-powered medical imaging analysis for prostate MRI
Author-email: "Ronald Marca, Rodrigo Salas, Sebastian Ponce, Paola Caprile, Cecilia Besa" <rnldmarca@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/Marquita-oss/DeepProstate
Project-URL: Documentation, https://DeepProstate.readthedocs.io
Project-URL: Repository, https://github.com/Marquita-oss/DeepProstate
Project-URL: Issues, https://github.com/Marquita-oss/DeepProstate/issues
Keywords: medical-imaging,prostate,mri,ai,deep-learning,nnunet
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Healthcare Industry
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
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: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy==2.3.4
Requires-Dist: scipy==1.16.3
Requires-Dist: pydicom==3.0.1
Requires-Dist: nibabel==5.3.2
Requires-Dist: SimpleITK==2.5.2
Requires-Dist: scikit-image==0.25.2
Requires-Dist: Pillow==12.0.0
Requires-Dist: psutil==7.1.2
Requires-Dist: torch==2.9.0
Requires-Dist: torchvision==0.24.0
Requires-Dist: nnunetv2==2.6.2
Requires-Dist: vtk==9.5.2
Requires-Dist: h5py==3.15.1
Requires-Dist: python-dotenv==1.2.1
Requires-Dist: PyYAML==6.0.3
Requires-Dist: python-dateutil==2.9.0.post0
Requires-Dist: PyQt6==6.10.0
Requires-Dist: pyqtdarktheme==0.1.7
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-qt>=4.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: flake8>=6.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=5.0; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=1.2; extra == "docs"
Dynamic: license-file

# DeepProstate

<p align="center">
  <img src="https://github.com/Marquita-oss/DeepProstate/blob/main/deepprostate/resources/image/logo2.svg?raw=true" alt="DeepProstate Logo" width="200"/>
</p>

<p align="center">
  <strong>AI-Powered Prostate MRI Analysis Platform</strong>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/version-1.5.0-blue.svg" alt="Version"/>
  <img src="https://img.shields.io/badge/Python-3.9+-blue.svg" alt="Python Version"/>
  <img src="https://img.shields.io/badge/PyQt-6-green.svg" alt="PyQt6"/>
  <img src="https://img.shields.io/badge/AI-nnUNet-orange.svg" alt="nnUNet"/>
  <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License"/>
</p>

---

- 🧠 **AI Segmentation**: Prostate gland, TZ/PZ zones and csPCa detection via nnUNet v2
- 👁️ **Multi-view Viewer**: Synchronized axial, sagittal and coronal views (Single & Quad layout)
- ✏️ **Manual Editing**: Brush, eraser and flood-fill tools with correct orientation in all planes
- 📊 **Quantitative Analysis**: Volume calculations and radiomics metrics
- 🔄 **Format Support**: DICOM, NIfTI (.nii / .nii.gz), MHA, NRRD
- 🌐 **Internationalization**: Spanish and English UI
- 🖥️ **Cross-platform**: Windows, macOS, Linux — standalone executable or PyPI package
- 🛡️ **Medical Compliance**: HIPAA-compliant logging and audit trails

---

## Installation

### Requirements

- **Python**: 3.9+
- **RAM**: 8 GB+ recommended
- **GPU**: NVIDIA GPU with CUDA (optional but highly recommended for AI inference)

### From PyPI (Recommended)

```bash
pip install deepprostate
```

### From Source

```bash
git clone https://github.com/Marquita-oss/DeepProstate.git
cd DeepProstate
pip install -e .
```

### GPU Support (Recommended for AI Analysis)

```bash
# CUDA 11.8
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu118

# CUDA 12.1
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu121
```

---

## Standalone Executables

Pre-built installers are available on the [Releases](https://github.com/Marquita-oss/DeepProstate/releases) page — no Python installation required.

| Platform | File |
|----------|------|
| Windows  | `DeepProstate-1.5.0-windows-setup.exe` |
| macOS    | `DeepProstate-macos-arm64.dmg` |
| Linux    | `DeepProstate-linux-x86_64.tar.gz` |

---

## Quick Start

```bash
deepprostate        # launch GUI (PyPI install)
```

### Basic Workflow

1. **Load Patient Data** — Patient Browser → "Load DICOM Folder" or "Load Single File"
2. **Load AI Models** — AI Analysis panel → "Load AI Models Path" → select nnUNet models folder
3. **Run AI Analysis** — select image → choose analysis type → "Run AI Analysis"
4. **Review & Refine** — Single/Quad view, Manual Editing tools, 3D viewer
5. **Export** — quantitative metrics via the Quantitative Analysis panel

---

## AI Models

| Model | Input | Output |
|-------|-------|--------|
| Prostate Gland | T2W | Complete prostate mask |
| Zonal Anatomy | T2W | TZ and PZ masks |
| csPCa Detection | T2W + ADC + HBV | Cancer lesion masks |

```
models/
├── Task500_ProstateGland/nnUNetTrainer__nnUNetPlans__3d_fullres/
├── Task501_ProstateTZPZ/nnUNetTrainer__nnUNetPlans__3d_fullres/
└── Task502_csPCa/nnUNetTrainer__nnUNetPlans__3d_fullres/
```

---

## Project Structure

```
deepprostate/
├── core/                        # Domain layer (entities, services, repositories)
├── use_cases/                   # Application layer (orchestrators)
├── frameworks/infrastructure/   # Infrastructure layer
│   ├── coordination/            # Workflow orchestration
│   ├── ui/                      # PyQt6 UI components
│   └── utils/                   # Helpers (resources, logging, i18n)
└── resources/                   # Icons, images, translations, config
```

---

## License & Disclaimer

**MIT License** — see [LICENSE](LICENSE).

> ⚠️ **Research use only.** Not FDA-approved. Not intended for clinical diagnostic decisions.

---

## Citation

```bibtex
@software{deepprostate2026,
  title   = {DeepProstate: AI-Powered Prostate MRI Analysis Platform},
  author  = {Marca, Ronald and Salas, Rodrigo and Ponce, Sebastian and Caprile, Paola and Besa, Cecilia},
  year    = {2026},
  version = {1.5.0},
  url     = {https://github.com/Marquita-oss/DeepProstate}
}
```

---

## Support

- **Issues**: [GitHub Issues](https://github.com/Marquita-oss/DeepProstate/issues)
- **Email**: rnldmarca@gmail.com

---

## Acknowledgments

- **nnUNet Team** — self-configuring medical image segmentation framework
- **PyQt6** — cross-platform UI framework
- **VTK** — 3D visualization toolkit
- **Medical Imaging Community** — feedback and testing

---

<p align="center">Made with ❤️ for the Medical Imaging Community</p>
