AutoMorphoTrack 1.0.0__tar.gz → 1.0.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. automorphotrack-1.0.5/AutoMorphoTrack.egg-info/PKG-INFO +135 -0
  2. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/AutoMorphoTrack.egg-info/SOURCES.txt +1 -0
  3. automorphotrack-1.0.5/LICENSE.md +21 -0
  4. automorphotrack-1.0.5/PKG-INFO +135 -0
  5. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/setup.cfg +4 -4
  6. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/setup.py +1 -1
  7. AutoMorphoTrack-1.0.0/AutoMorphoTrack.egg-info/PKG-INFO +0 -115
  8. AutoMorphoTrack-1.0.0/PKG-INFO +0 -115
  9. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/AutoMorphoTrack.egg-info/dependency_links.txt +0 -0
  10. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/AutoMorphoTrack.egg-info/requires.txt +0 -0
  11. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/AutoMorphoTrack.egg-info/top_level.txt +0 -0
  12. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/MANIFEST.in +0 -0
  13. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/README.md +0 -0
  14. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/__init__.py +0 -0
  15. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/colocalization.py +0 -0
  16. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/detection.py +0 -0
  17. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/lyso_count.py +0 -0
  18. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/morphology.py +0 -0
  19. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/motility.py +0 -0
  20. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/shape_features.py +0 -0
  21. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/shape_profiling.py +0 -0
  22. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/summary.py +0 -0
  23. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/tracking.py +0 -0
  24. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/tracking_overlay.py +0 -0
  25. {AutoMorphoTrack-1.0.0 → automorphotrack-1.0.5}/automorphotrack/utils.py +0 -0
@@ -0,0 +1,135 @@
1
+ Metadata-Version: 2.4
2
+ Name: AutoMorphoTrack
3
+ Version: 1.0.5
4
+ 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.
5
+ Home-page: https://github.com/abayatibrain/AMTpackage
6
+ Author: Armin Bayati
7
+ Author-email: a.bayati.brain@gmail.com
8
+ License: MIT
9
+ Project-URL: Documentation, https://github.com/abayatibrain/AMTpackage
10
+ Project-URL: Source, https://github.com/abayatibrain/AMTpackage
11
+ Project-URL: Tracker, https://github.com/abayatibrain/AMTpackage/issues
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Intended Audience :: Science/Research
16
+ Classifier: Topic :: Scientific/Engineering :: Image Processing
17
+ Requires-Python: >=3.9
18
+ Description-Content-Type: text/markdown
19
+ License-File: LICENSE.md
20
+ Requires-Dist: numpy>=1.23.0
21
+ Requires-Dist: pandas>=1.5.0
22
+ Requires-Dist: matplotlib>=3.6.0
23
+ Requires-Dist: seaborn>=0.12.0
24
+ Requires-Dist: opencv-python>=4.6.0
25
+ Requires-Dist: scikit-image>=0.19.0
26
+ Requires-Dist: scipy>=1.9.0
27
+ Requires-Dist: tifffile>=2022.8.12
28
+ Dynamic: author
29
+ Dynamic: author-email
30
+ Dynamic: classifier
31
+ Dynamic: description
32
+ Dynamic: description-content-type
33
+ Dynamic: home-page
34
+ Dynamic: license
35
+ Dynamic: license-file
36
+ Dynamic: project-url
37
+ Dynamic: requires-dist
38
+ Dynamic: requires-python
39
+ Dynamic: summary
40
+
41
+ # AutoMorphoTrack
42
+
43
+ **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.
44
+
45
+ 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.
46
+ Repository: [https://github.com/abayatibrain/automorphotrack](https://github.com/abayatibrain/automorphotrack)
47
+
48
+ ---
49
+
50
+ ## 🧬 Overview
51
+
52
+ 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.
53
+
54
+ **Pipeline stages:**
55
+
56
+ 1. **Detection** – Organelle segmentation and outline visualization
57
+ 2. **Lysosomal Counting** – Per-frame lysosome enumeration and temporal profiling
58
+ 3. **Morphology Classification** – Elongated vs. punctate mitochondria
59
+ 4. **Shape Feature Extraction** – Area, circularity, solidity, aspect ratio, orientation
60
+ 5. **Tracking** – Cumulative organelle trajectories (mitochondria, lysosomes, composite)
61
+ 6. **Motility Analysis** – Velocity, displacement, and trajectory-based statistics
62
+ 7. **Colocalization** – Bright-blue overlap overlays and correlation metrics
63
+ 8. **Integrated Summary** – Correlation matrices linking morphology, motility, and overlap
64
+
65
+ Each stage outputs high-resolution figures, videos, and CSV data tables stored in standardized subdirectories, ensuring reproducibility and compatibility with any image dataset.
66
+
67
+ ---
68
+
69
+ ## 📦 Installation
70
+
71
+ Install directly from PyPI:
72
+
73
+ ```bash
74
+ pip install AutoMorphoTrack
75
+ ```
76
+
77
+ Or from source:
78
+
79
+ ```bash
80
+ git clone https://github.com/abayatibrain/automorphotrack.git
81
+ cd automorphotrack
82
+ pip install -e .
83
+ ```
84
+
85
+ ---
86
+
87
+ ## 🚀 Basic Usage
88
+
89
+ ```python
90
+ from automorphotrack import *
91
+
92
+ tif_path = "Composite.tif"
93
+
94
+ detect_organelles(tif_path)
95
+ count_lysosomes_per_frame(tif_path)
96
+ classify_morphology(tif_path)
97
+ analyze_shape_features(tif_path)
98
+ track_organelles(tif_path)
99
+ analyze_motility()
100
+ analyze_colocalization(tif_path)
101
+ summarize_integrated_data()
102
+ ```
103
+
104
+ Each function automatically generates visual and quantitative outputs at every step.
105
+
106
+ ---
107
+
108
+ ## 📁 Outputs
109
+
110
+ | Step | Output Type | Example Files |
111
+ |------|--------------|---------------|
112
+ | Detection | PNG + MP4 | `Mito_Frame0.png`, `Mitochondria_Detection.mp4` |
113
+ | Lysosome Count | PNG + CSV + MP4 | `Lyso_Count_Plot.png`, `Lysosome_Counts.csv` |
114
+ | Morphology | PNG + MP4 + CSV | `Morphology_Frame0_Labeled.png`, `Morphology_Labeled.mp4` |
115
+ | Shape Features | PNG + CSV | `Shape_Distributions.png`, `Mito_ShapeMetrics.csv` |
116
+ | Tracking | PNG + MP4 + CSV | `Cumulative_Mito.png`, `Mito_Tracks.csv` |
117
+ | Motility | PNG + CSV | `Motility_Distributions.png`, `Motility_Scatter.png` |
118
+ | Colocalization | PNG + MP4 + CSV | `Colocalization_Frame0.png`, `Colocalization.csv` |
119
+ | Summary | PNG + CSV | `Integrated_CorrelationMatrix.png`, `Integrated_Merged_Data.csv` |
120
+
121
+ ---
122
+
123
+ ## 🔧 Dependencies
124
+
125
+ - Python ≥ 3.9
126
+ - numpy, pandas, matplotlib, seaborn, opencv-python, scikit-image, scipy, tifffile
127
+
128
+ ---
129
+
130
+ ## 🧩 Citation
131
+
132
+ If you use **AutoMorphoTrack** in your research, please cite:
133
+
134
+ > **Bayati, A. (2025)**. AutoMorphoTrack: An accessible Python framework for automated analysis of organelle morphology and motility.
135
+ > *GitHub Repository:* [https://github.com/abayatibrain/automorphotrack](https://github.com/abayatibrain/automorphotrack)
@@ -1,3 +1,4 @@
1
+ LICENSE.md
1
2
  MANIFEST.in
2
3
  README.md
3
4
  setup.py
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Armin Bayati
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,135 @@
1
+ Metadata-Version: 2.4
2
+ Name: AutoMorphoTrack
3
+ Version: 1.0.5
4
+ 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.
5
+ Home-page: https://github.com/abayatibrain/AMTpackage
6
+ Author: Armin Bayati
7
+ Author-email: a.bayati.brain@gmail.com
8
+ License: MIT
9
+ Project-URL: Documentation, https://github.com/abayatibrain/AMTpackage
10
+ Project-URL: Source, https://github.com/abayatibrain/AMTpackage
11
+ Project-URL: Tracker, https://github.com/abayatibrain/AMTpackage/issues
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Intended Audience :: Science/Research
16
+ Classifier: Topic :: Scientific/Engineering :: Image Processing
17
+ Requires-Python: >=3.9
18
+ Description-Content-Type: text/markdown
19
+ License-File: LICENSE.md
20
+ Requires-Dist: numpy>=1.23.0
21
+ Requires-Dist: pandas>=1.5.0
22
+ Requires-Dist: matplotlib>=3.6.0
23
+ Requires-Dist: seaborn>=0.12.0
24
+ Requires-Dist: opencv-python>=4.6.0
25
+ Requires-Dist: scikit-image>=0.19.0
26
+ Requires-Dist: scipy>=1.9.0
27
+ Requires-Dist: tifffile>=2022.8.12
28
+ Dynamic: author
29
+ Dynamic: author-email
30
+ Dynamic: classifier
31
+ Dynamic: description
32
+ Dynamic: description-content-type
33
+ Dynamic: home-page
34
+ Dynamic: license
35
+ Dynamic: license-file
36
+ Dynamic: project-url
37
+ Dynamic: requires-dist
38
+ Dynamic: requires-python
39
+ Dynamic: summary
40
+
41
+ # AutoMorphoTrack
42
+
43
+ **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.
44
+
45
+ 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.
46
+ Repository: [https://github.com/abayatibrain/automorphotrack](https://github.com/abayatibrain/automorphotrack)
47
+
48
+ ---
49
+
50
+ ## 🧬 Overview
51
+
52
+ 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.
53
+
54
+ **Pipeline stages:**
55
+
56
+ 1. **Detection** – Organelle segmentation and outline visualization
57
+ 2. **Lysosomal Counting** – Per-frame lysosome enumeration and temporal profiling
58
+ 3. **Morphology Classification** – Elongated vs. punctate mitochondria
59
+ 4. **Shape Feature Extraction** – Area, circularity, solidity, aspect ratio, orientation
60
+ 5. **Tracking** – Cumulative organelle trajectories (mitochondria, lysosomes, composite)
61
+ 6. **Motility Analysis** – Velocity, displacement, and trajectory-based statistics
62
+ 7. **Colocalization** – Bright-blue overlap overlays and correlation metrics
63
+ 8. **Integrated Summary** – Correlation matrices linking morphology, motility, and overlap
64
+
65
+ Each stage outputs high-resolution figures, videos, and CSV data tables stored in standardized subdirectories, ensuring reproducibility and compatibility with any image dataset.
66
+
67
+ ---
68
+
69
+ ## 📦 Installation
70
+
71
+ Install directly from PyPI:
72
+
73
+ ```bash
74
+ pip install AutoMorphoTrack
75
+ ```
76
+
77
+ Or from source:
78
+
79
+ ```bash
80
+ git clone https://github.com/abayatibrain/automorphotrack.git
81
+ cd automorphotrack
82
+ pip install -e .
83
+ ```
84
+
85
+ ---
86
+
87
+ ## 🚀 Basic Usage
88
+
89
+ ```python
90
+ from automorphotrack import *
91
+
92
+ tif_path = "Composite.tif"
93
+
94
+ detect_organelles(tif_path)
95
+ count_lysosomes_per_frame(tif_path)
96
+ classify_morphology(tif_path)
97
+ analyze_shape_features(tif_path)
98
+ track_organelles(tif_path)
99
+ analyze_motility()
100
+ analyze_colocalization(tif_path)
101
+ summarize_integrated_data()
102
+ ```
103
+
104
+ Each function automatically generates visual and quantitative outputs at every step.
105
+
106
+ ---
107
+
108
+ ## 📁 Outputs
109
+
110
+ | Step | Output Type | Example Files |
111
+ |------|--------------|---------------|
112
+ | Detection | PNG + MP4 | `Mito_Frame0.png`, `Mitochondria_Detection.mp4` |
113
+ | Lysosome Count | PNG + CSV + MP4 | `Lyso_Count_Plot.png`, `Lysosome_Counts.csv` |
114
+ | Morphology | PNG + MP4 + CSV | `Morphology_Frame0_Labeled.png`, `Morphology_Labeled.mp4` |
115
+ | Shape Features | PNG + CSV | `Shape_Distributions.png`, `Mito_ShapeMetrics.csv` |
116
+ | Tracking | PNG + MP4 + CSV | `Cumulative_Mito.png`, `Mito_Tracks.csv` |
117
+ | Motility | PNG + CSV | `Motility_Distributions.png`, `Motility_Scatter.png` |
118
+ | Colocalization | PNG + MP4 + CSV | `Colocalization_Frame0.png`, `Colocalization.csv` |
119
+ | Summary | PNG + CSV | `Integrated_CorrelationMatrix.png`, `Integrated_Merged_Data.csv` |
120
+
121
+ ---
122
+
123
+ ## 🔧 Dependencies
124
+
125
+ - Python ≥ 3.9
126
+ - numpy, pandas, matplotlib, seaborn, opencv-python, scikit-image, scipy, tifffile
127
+
128
+ ---
129
+
130
+ ## 🧩 Citation
131
+
132
+ If you use **AutoMorphoTrack** in your research, please cite:
133
+
134
+ > **Bayati, A. (2025)**. AutoMorphoTrack: An accessible Python framework for automated analysis of organelle morphology and motility.
135
+ > *GitHub Repository:* [https://github.com/abayatibrain/automorphotrack](https://github.com/abayatibrain/automorphotrack)
@@ -1,4 +1,4 @@
1
- [egg_info]
2
- tag_build =
3
- tag_date = 0
4
-
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -6,7 +6,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
6
6
 
7
7
  setup(
8
8
  name="AutoMorphoTrack",
9
- version="1.0.0",
9
+ version="1.0.5",
10
10
  author="Armin Bayati",
11
11
  author_email="a.bayati.brain@gmail.com",
12
12
  description=(
@@ -1,115 +0,0 @@
1
- Metadata-Version: 2.1
2
- Name: AutoMorphoTrack
3
- Version: 1.0.0
4
- 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.
5
- Home-page: https://github.com/abayatibrain/AMTpackage
6
- Author: Armin Bayati
7
- Author-email: a.bayati.brain@gmail.com
8
- License: MIT
9
- Project-URL: Documentation, https://github.com/abayatibrain/AMTpackage
10
- Project-URL: Source, https://github.com/abayatibrain/AMTpackage
11
- Project-URL: Tracker, https://github.com/abayatibrain/AMTpackage/issues
12
- Description: # AutoMorphoTrack
13
-
14
- **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.
15
-
16
- 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.
17
- Repository: [https://github.com/abayatibrain/automorphotrack](https://github.com/abayatibrain/automorphotrack)
18
-
19
- ---
20
-
21
- ## 🧬 Overview
22
-
23
- 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.
24
-
25
- **Pipeline stages:**
26
-
27
- 1. **Detection** – Organelle segmentation and outline visualization
28
- 2. **Lysosomal Counting** – Per-frame lysosome enumeration and temporal profiling
29
- 3. **Morphology Classification** – Elongated vs. punctate mitochondria
30
- 4. **Shape Feature Extraction** – Area, circularity, solidity, aspect ratio, orientation
31
- 5. **Tracking** – Cumulative organelle trajectories (mitochondria, lysosomes, composite)
32
- 6. **Motility Analysis** – Velocity, displacement, and trajectory-based statistics
33
- 7. **Colocalization** – Bright-blue overlap overlays and correlation metrics
34
- 8. **Integrated Summary** – Correlation matrices linking morphology, motility, and overlap
35
-
36
- Each stage outputs high-resolution figures, videos, and CSV data tables stored in standardized subdirectories, ensuring reproducibility and compatibility with any image dataset.
37
-
38
- ---
39
-
40
- ## 📦 Installation
41
-
42
- Install directly from PyPI:
43
-
44
- ```bash
45
- pip install AutoMorphoTrack
46
- ```
47
-
48
- Or from source:
49
-
50
- ```bash
51
- git clone https://github.com/abayatibrain/automorphotrack.git
52
- cd automorphotrack
53
- pip install -e .
54
- ```
55
-
56
- ---
57
-
58
- ## 🚀 Basic Usage
59
-
60
- ```python
61
- from automorphotrack import *
62
-
63
- tif_path = "Composite.tif"
64
-
65
- detect_organelles(tif_path)
66
- count_lysosomes_per_frame(tif_path)
67
- classify_morphology(tif_path)
68
- analyze_shape_features(tif_path)
69
- track_organelles(tif_path)
70
- analyze_motility()
71
- analyze_colocalization(tif_path)
72
- summarize_integrated_data()
73
- ```
74
-
75
- Each function automatically generates visual and quantitative outputs at every step.
76
-
77
- ---
78
-
79
- ## 📁 Outputs
80
-
81
- | Step | Output Type | Example Files |
82
- |------|--------------|---------------|
83
- | Detection | PNG + MP4 | `Mito_Frame0.png`, `Mitochondria_Detection.mp4` |
84
- | Lysosome Count | PNG + CSV + MP4 | `Lyso_Count_Plot.png`, `Lysosome_Counts.csv` |
85
- | Morphology | PNG + MP4 + CSV | `Morphology_Frame0_Labeled.png`, `Morphology_Labeled.mp4` |
86
- | Shape Features | PNG + CSV | `Shape_Distributions.png`, `Mito_ShapeMetrics.csv` |
87
- | Tracking | PNG + MP4 + CSV | `Cumulative_Mito.png`, `Mito_Tracks.csv` |
88
- | Motility | PNG + CSV | `Motility_Distributions.png`, `Motility_Scatter.png` |
89
- | Colocalization | PNG + MP4 + CSV | `Colocalization_Frame0.png`, `Colocalization.csv` |
90
- | Summary | PNG + CSV | `Integrated_CorrelationMatrix.png`, `Integrated_Merged_Data.csv` |
91
-
92
- ---
93
-
94
- ## 🔧 Dependencies
95
-
96
- - Python ≥ 3.9
97
- - numpy, pandas, matplotlib, seaborn, opencv-python, scikit-image, scipy, tifffile
98
-
99
- ---
100
-
101
- ## 🧩 Citation
102
-
103
- If you use **AutoMorphoTrack** in your research, please cite:
104
-
105
- > **Bayati, A. (2025)**. AutoMorphoTrack: An accessible Python framework for automated analysis of organelle morphology and motility.
106
- > *GitHub Repository:* [https://github.com/abayatibrain/automorphotrack](https://github.com/abayatibrain/automorphotrack)
107
-
108
- Platform: UNKNOWN
109
- Classifier: Programming Language :: Python :: 3
110
- Classifier: License :: OSI Approved :: MIT License
111
- Classifier: Operating System :: OS Independent
112
- Classifier: Intended Audience :: Science/Research
113
- Classifier: Topic :: Scientific/Engineering :: Image Processing
114
- Requires-Python: >=3.9
115
- Description-Content-Type: text/markdown
@@ -1,115 +0,0 @@
1
- Metadata-Version: 2.1
2
- Name: AutoMorphoTrack
3
- Version: 1.0.0
4
- 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.
5
- Home-page: https://github.com/abayatibrain/AMTpackage
6
- Author: Armin Bayati
7
- Author-email: a.bayati.brain@gmail.com
8
- License: MIT
9
- Project-URL: Documentation, https://github.com/abayatibrain/AMTpackage
10
- Project-URL: Source, https://github.com/abayatibrain/AMTpackage
11
- Project-URL: Tracker, https://github.com/abayatibrain/AMTpackage/issues
12
- Description: # AutoMorphoTrack
13
-
14
- **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.
15
-
16
- 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.
17
- Repository: [https://github.com/abayatibrain/automorphotrack](https://github.com/abayatibrain/automorphotrack)
18
-
19
- ---
20
-
21
- ## 🧬 Overview
22
-
23
- 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.
24
-
25
- **Pipeline stages:**
26
-
27
- 1. **Detection** – Organelle segmentation and outline visualization
28
- 2. **Lysosomal Counting** – Per-frame lysosome enumeration and temporal profiling
29
- 3. **Morphology Classification** – Elongated vs. punctate mitochondria
30
- 4. **Shape Feature Extraction** – Area, circularity, solidity, aspect ratio, orientation
31
- 5. **Tracking** – Cumulative organelle trajectories (mitochondria, lysosomes, composite)
32
- 6. **Motility Analysis** – Velocity, displacement, and trajectory-based statistics
33
- 7. **Colocalization** – Bright-blue overlap overlays and correlation metrics
34
- 8. **Integrated Summary** – Correlation matrices linking morphology, motility, and overlap
35
-
36
- Each stage outputs high-resolution figures, videos, and CSV data tables stored in standardized subdirectories, ensuring reproducibility and compatibility with any image dataset.
37
-
38
- ---
39
-
40
- ## 📦 Installation
41
-
42
- Install directly from PyPI:
43
-
44
- ```bash
45
- pip install AutoMorphoTrack
46
- ```
47
-
48
- Or from source:
49
-
50
- ```bash
51
- git clone https://github.com/abayatibrain/automorphotrack.git
52
- cd automorphotrack
53
- pip install -e .
54
- ```
55
-
56
- ---
57
-
58
- ## 🚀 Basic Usage
59
-
60
- ```python
61
- from automorphotrack import *
62
-
63
- tif_path = "Composite.tif"
64
-
65
- detect_organelles(tif_path)
66
- count_lysosomes_per_frame(tif_path)
67
- classify_morphology(tif_path)
68
- analyze_shape_features(tif_path)
69
- track_organelles(tif_path)
70
- analyze_motility()
71
- analyze_colocalization(tif_path)
72
- summarize_integrated_data()
73
- ```
74
-
75
- Each function automatically generates visual and quantitative outputs at every step.
76
-
77
- ---
78
-
79
- ## 📁 Outputs
80
-
81
- | Step | Output Type | Example Files |
82
- |------|--------------|---------------|
83
- | Detection | PNG + MP4 | `Mito_Frame0.png`, `Mitochondria_Detection.mp4` |
84
- | Lysosome Count | PNG + CSV + MP4 | `Lyso_Count_Plot.png`, `Lysosome_Counts.csv` |
85
- | Morphology | PNG + MP4 + CSV | `Morphology_Frame0_Labeled.png`, `Morphology_Labeled.mp4` |
86
- | Shape Features | PNG + CSV | `Shape_Distributions.png`, `Mito_ShapeMetrics.csv` |
87
- | Tracking | PNG + MP4 + CSV | `Cumulative_Mito.png`, `Mito_Tracks.csv` |
88
- | Motility | PNG + CSV | `Motility_Distributions.png`, `Motility_Scatter.png` |
89
- | Colocalization | PNG + MP4 + CSV | `Colocalization_Frame0.png`, `Colocalization.csv` |
90
- | Summary | PNG + CSV | `Integrated_CorrelationMatrix.png`, `Integrated_Merged_Data.csv` |
91
-
92
- ---
93
-
94
- ## 🔧 Dependencies
95
-
96
- - Python ≥ 3.9
97
- - numpy, pandas, matplotlib, seaborn, opencv-python, scikit-image, scipy, tifffile
98
-
99
- ---
100
-
101
- ## 🧩 Citation
102
-
103
- If you use **AutoMorphoTrack** in your research, please cite:
104
-
105
- > **Bayati, A. (2025)**. AutoMorphoTrack: An accessible Python framework for automated analysis of organelle morphology and motility.
106
- > *GitHub Repository:* [https://github.com/abayatibrain/automorphotrack](https://github.com/abayatibrain/automorphotrack)
107
-
108
- Platform: UNKNOWN
109
- Classifier: Programming Language :: Python :: 3
110
- Classifier: License :: OSI Approved :: MIT License
111
- Classifier: Operating System :: OS Independent
112
- Classifier: Intended Audience :: Science/Research
113
- Classifier: Topic :: Scientific/Engineering :: Image Processing
114
- Requires-Python: >=3.9
115
- Description-Content-Type: text/markdown