Metadata-Version: 2.4
Name: AutoMorphoTrack
Version: 1.0.5
Summary: AutoMorphoTrack is an open-source Python package for automated detection, morphology classification, motility tracking, and colocalization analysis of organelles in multichannel fluorescence microscopy data.
Home-page: https://github.com/abayatibrain/AMTpackage
Author: Armin Bayati
Author-email: a.bayati.brain@gmail.com
License: MIT
Project-URL: Documentation, https://github.com/abayatibrain/AMTpackage
Project-URL: Source, https://github.com/abayatibrain/AMTpackage
Project-URL: Tracker, https://github.com/abayatibrain/AMTpackage/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Image Processing
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: numpy>=1.23.0
Requires-Dist: pandas>=1.5.0
Requires-Dist: matplotlib>=3.6.0
Requires-Dist: seaborn>=0.12.0
Requires-Dist: opencv-python>=4.6.0
Requires-Dist: scikit-image>=0.19.0
Requires-Dist: scipy>=1.9.0
Requires-Dist: tifffile>=2022.8.12
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# AutoMorphoTrack

**AutoMorphoTrack** is an open-source Python package for automated detection, morphology classification, shape profiling, motility tracking, and colocalization analysis of subcellular organelles in multichannel fluorescence microscopy data.  

This package represents the fully modular version of the **AutoMorphoTrack pipeline**, originally developed as a Jupyter Notebook by **Armin Bayati, Ph.D.**, and now distributed as an installable Python framework.  
Repository: [https://github.com/abayatibrain/automorphotrack](https://github.com/abayatibrain/automorphotrack)

---

## 🧬 Overview

AutoMorphoTrack automates quantitative analysis of time-lapse `.tif` image stacks—typically dual-channel recordings of mitochondria and lysosomes—and generates publication-ready visual and numerical outputs at every step of the analysis pipeline.

**Pipeline stages:**

1. **Detection** – Organelle segmentation and outline visualization  
2. **Lysosomal Counting** – Per-frame lysosome enumeration and temporal profiling  
3. **Morphology Classification** – Elongated vs. punctate mitochondria  
4. **Shape Feature Extraction** – Area, circularity, solidity, aspect ratio, orientation  
5. **Tracking** – Cumulative organelle trajectories (mitochondria, lysosomes, composite)  
6. **Motility Analysis** – Velocity, displacement, and trajectory-based statistics  
7. **Colocalization** – Bright-blue overlap overlays and correlation metrics  
8. **Integrated Summary** – Correlation matrices linking morphology, motility, and overlap  

Each stage outputs high-resolution figures, videos, and CSV data tables stored in standardized subdirectories, ensuring reproducibility and compatibility with any image dataset.

---

## 📦 Installation

Install directly from PyPI:

```bash
pip install AutoMorphoTrack
```

Or from source:

```bash
git clone https://github.com/abayatibrain/automorphotrack.git
cd automorphotrack
pip install -e .
```

---

## 🚀 Basic Usage

```python
from automorphotrack import *

tif_path = "Composite.tif"

detect_organelles(tif_path)
count_lysosomes_per_frame(tif_path)
classify_morphology(tif_path)
analyze_shape_features(tif_path)
track_organelles(tif_path)
analyze_motility()
analyze_colocalization(tif_path)
summarize_integrated_data()
```

Each function automatically generates visual and quantitative outputs at every step.

---

## 📁 Outputs

| Step | Output Type | Example Files |
|------|--------------|---------------|
| Detection | PNG + MP4 | `Mito_Frame0.png`, `Mitochondria_Detection.mp4` |
| Lysosome Count | PNG + CSV + MP4 | `Lyso_Count_Plot.png`, `Lysosome_Counts.csv` |
| Morphology | PNG + MP4 + CSV | `Morphology_Frame0_Labeled.png`, `Morphology_Labeled.mp4` |
| Shape Features | PNG + CSV | `Shape_Distributions.png`, `Mito_ShapeMetrics.csv` |
| Tracking | PNG + MP4 + CSV | `Cumulative_Mito.png`, `Mito_Tracks.csv` |
| Motility | PNG + CSV | `Motility_Distributions.png`, `Motility_Scatter.png` |
| Colocalization | PNG + MP4 + CSV | `Colocalization_Frame0.png`, `Colocalization.csv` |
| Summary | PNG + CSV | `Integrated_CorrelationMatrix.png`, `Integrated_Merged_Data.csv` |

---

## 🔧 Dependencies

- Python ≥ 3.9  
- numpy, pandas, matplotlib, seaborn, opencv-python, scikit-image, scipy, tifffile

---

## 🧩 Citation

If you use **AutoMorphoTrack** in your research, please cite:

> **Bayati, A. (2025)**. AutoMorphoTrack: An accessible Python framework for automated analysis of organelle morphology and motility.  
> *GitHub Repository:* [https://github.com/abayatibrain/automorphotrack](https://github.com/abayatibrain/automorphotrack)
