cabana 0.0.2__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.
cabana-0.0.2/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Gavin Lin
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.
cabana-0.0.2/PKG-INFO ADDED
@@ -0,0 +1,114 @@
1
+ Metadata-Version: 2.2
2
+ Name: cabana
3
+ Version: 0.0.2
4
+ Summary: Collagen fibre analyser for quantifying collagen fibre architecture in IHC and fluorescence microscopy images.
5
+ Home-page: https://github.com/lxfhfut/cabana.git
6
+ Author: Gavin Lin
7
+ Author-email: x.lin@garvan.org.au
8
+ Classifier: Programming Language :: Python :: 3
9
+ Classifier: License :: OSI Approved :: MIT License
10
+ Classifier: Operating System :: OS Independent
11
+ Description-Content-Type: text/markdown
12
+ License-File: LICENSE
13
+ Requires-Dist: colorlog
14
+ Requires-Dist: gitpython
15
+ Requires-Dist: imutils
16
+ Requires-Dist: jaraco.collections
17
+ Requires-Dist: numba
18
+ Requires-Dist: opencv-python
19
+ Requires-Dist: pip-chill
20
+ Requires-Dist: pyqt5
21
+ Requires-Dist: pyyaml
22
+ Requires-Dist: scikit-learn
23
+ Requires-Dist: seaborn
24
+ Requires-Dist: seaborn-image
25
+ Requires-Dist: send2trash
26
+ Requires-Dist: tomli
27
+ Requires-Dist: torch
28
+ Requires-Dist: tqdm
29
+ Requires-Dist: twine
30
+ Dynamic: author
31
+ Dynamic: author-email
32
+ Dynamic: classifier
33
+ Dynamic: description
34
+ Dynamic: description-content-type
35
+ Dynamic: home-page
36
+ Dynamic: requires-dist
37
+ Dynamic: summary
38
+
39
+ [//]: # (# CABANA - Collagen Fibre Analyzer)
40
+ ![image](cabana.png)
41
+ [![PyPI version](https://badge.fury.io/py/cabana.svg)](https://pypi.org/project/cabana/1.0.1/)
42
+ [![Documentation Status](https://readthedocs.org/projects/cabana/badge/?version=latest)](https://cabana.readthedocs.io/en/latest/?badge=latest)
43
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
44
+
45
+ CABANA (CollAgen FiBre ANAlyzer) is a comprehensive toolkit for analyzing collagen fibre architecture in immunohistochemistry (IHC) and fluorescence microscopy images. It provides:
46
+
47
+ - Automated detection and quantification of collagen fibres
48
+ - Analysis of fibre orientation, length, and thickness
49
+ - Gap analysis for inter-fibre and intra-fibre spaces
50
+ - Interactive parameter optimization interface
51
+ - Batch processing for large datasets
52
+
53
+ CABANA combines advanced computer vision algorithms with an intuitive user interface, making it accessible to researchers without extensive programming experience while providing detailed quantitative data for comprehensive analysis of collagen architecture.
54
+
55
+ ## System Requirements
56
+
57
+ - **Processor (CPU):** Intel Core i7, AMD Ryzen 7, or higher recommended
58
+ - **Memory (RAM):** Minimum 16 GB, 32 GB recommended
59
+ - **GPU:** NVIDIA GeForce GTX/RTX series with at least 10 GB VRAM recommended
60
+ - **Python:** 3.8 or newer
61
+
62
+
63
+ ## Quick Installation
64
+
65
+ Install CABANA using pip:
66
+
67
+ ```bash
68
+ pip install -U cabana
69
+ ```
70
+ or install the latest version on GitHub:
71
+
72
+ ```bash
73
+ pip install git+https://github.com/lxfhfut/Cabana.git
74
+ ```
75
+
76
+ After installation, you can launch the CABANA GUI by running:
77
+
78
+ ```bash
79
+ python -m cabana
80
+ ```
81
+
82
+ Alternatively, you can import CABANA in your Python code for customized analysis (**see examples in Tutorials**):
83
+
84
+ ```python
85
+ import cabana
86
+ ```
87
+
88
+ ## Documentation
89
+
90
+ Comprehensive documentation is available at:
91
+ [https://cabana.readthedocs.io/en/latest/](https://cabana.readthedocs.io/en/latest/)
92
+
93
+ ## Tutorials
94
+
95
+ We provide an interactive Jupyter notebook tutorial to help you get started:
96
+ [CABANA Tutorial](https://cabana.readthedocs.io/en/latest/_static/tutorial.ipynb)
97
+
98
+ ## Citation
99
+
100
+ If you use CABANA in your research, please cite:
101
+ <!--
102
+ ```
103
+ Magenau A, et al. (2025). CABANA: A comprehensive toolkit for collagen fibre analysis in biomedical imaging. Journal of XYZ. DOI: XYZ
104
+ ```-->
105
+
106
+ ## License
107
+
108
+ CABANA is released under the MIT License.
109
+
110
+ ## Contact
111
+
112
+ For questions and support, please contact:
113
+ - Xufeng Lin - <x.lin@garvan.org.au>
114
+ - Astrid Magenau - <a.magenau@garvan.org.au>
cabana-0.0.2/README.md ADDED
@@ -0,0 +1,76 @@
1
+ [//]: # (# CABANA - Collagen Fibre Analyzer)
2
+ ![image](cabana.png)
3
+ [![PyPI version](https://badge.fury.io/py/cabana.svg)](https://pypi.org/project/cabana/1.0.1/)
4
+ [![Documentation Status](https://readthedocs.org/projects/cabana/badge/?version=latest)](https://cabana.readthedocs.io/en/latest/?badge=latest)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
+
7
+ CABANA (CollAgen FiBre ANAlyzer) is a comprehensive toolkit for analyzing collagen fibre architecture in immunohistochemistry (IHC) and fluorescence microscopy images. It provides:
8
+
9
+ - Automated detection and quantification of collagen fibres
10
+ - Analysis of fibre orientation, length, and thickness
11
+ - Gap analysis for inter-fibre and intra-fibre spaces
12
+ - Interactive parameter optimization interface
13
+ - Batch processing for large datasets
14
+
15
+ CABANA combines advanced computer vision algorithms with an intuitive user interface, making it accessible to researchers without extensive programming experience while providing detailed quantitative data for comprehensive analysis of collagen architecture.
16
+
17
+ ## System Requirements
18
+
19
+ - **Processor (CPU):** Intel Core i7, AMD Ryzen 7, or higher recommended
20
+ - **Memory (RAM):** Minimum 16 GB, 32 GB recommended
21
+ - **GPU:** NVIDIA GeForce GTX/RTX series with at least 10 GB VRAM recommended
22
+ - **Python:** 3.8 or newer
23
+
24
+
25
+ ## Quick Installation
26
+
27
+ Install CABANA using pip:
28
+
29
+ ```bash
30
+ pip install -U cabana
31
+ ```
32
+ or install the latest version on GitHub:
33
+
34
+ ```bash
35
+ pip install git+https://github.com/lxfhfut/Cabana.git
36
+ ```
37
+
38
+ After installation, you can launch the CABANA GUI by running:
39
+
40
+ ```bash
41
+ python -m cabana
42
+ ```
43
+
44
+ Alternatively, you can import CABANA in your Python code for customized analysis (**see examples in Tutorials**):
45
+
46
+ ```python
47
+ import cabana
48
+ ```
49
+
50
+ ## Documentation
51
+
52
+ Comprehensive documentation is available at:
53
+ [https://cabana.readthedocs.io/en/latest/](https://cabana.readthedocs.io/en/latest/)
54
+
55
+ ## Tutorials
56
+
57
+ We provide an interactive Jupyter notebook tutorial to help you get started:
58
+ [CABANA Tutorial](https://cabana.readthedocs.io/en/latest/_static/tutorial.ipynb)
59
+
60
+ ## Citation
61
+
62
+ If you use CABANA in your research, please cite:
63
+ <!--
64
+ ```
65
+ Magenau A, et al. (2025). CABANA: A comprehensive toolkit for collagen fibre analysis in biomedical imaging. Journal of XYZ. DOI: XYZ
66
+ ```-->
67
+
68
+ ## License
69
+
70
+ CABANA is released under the MIT License.
71
+
72
+ ## Contact
73
+
74
+ For questions and support, please contact:
75
+ - Xufeng Lin - <x.lin@garvan.org.au>
76
+ - Astrid Magenau - <a.magenau@garvan.org.au>
@@ -0,0 +1,4 @@
1
+ name = "cabana"
2
+
3
+ from .batch_processor import BatchProcessor
4
+ from .cabana import Cabana
@@ -0,0 +1,21 @@
1
+ from PyQt5.QtWidgets import QApplication
2
+ from PyQt5.QtGui import QIcon
3
+ from PyQt5.QtCore import Qt
4
+ import sys
5
+ from pathlib import Path
6
+ from .cabana_gui import MainWindow
7
+
8
+ def main():
9
+ # Enable High DPI display before creating QApplication
10
+ QApplication.setAttribute(Qt.AA_EnableHighDpiScaling, True)
11
+ QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps, True)
12
+
13
+ app = QApplication(sys.argv)
14
+ window = MainWindow()
15
+ icon_path = Path(__file__).parent.parent / "cabana-logo.ico"
16
+ app.setWindowIcon(QIcon(str(icon_path)))
17
+ window.show()
18
+ sys.exit(app.exec_())
19
+
20
+ if __name__ == "__main__":
21
+ main()