Metadata-Version: 2.4
Name: cabana
Version: 0.1.5
Summary: Collagen fibre analyser for quantifying collagen fibre architecture in IHC and fluorescence microscopy images.
Home-page: https://github.com/lxfhfut/cabana.git
Author: Gavin Lin
Author-email: x.lin@garvan.org.au
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: colorlog
Requires-Dist: gitpython
Requires-Dist: imutils
Requires-Dist: jaraco.collections
Requires-Dist: numba
Requires-Dist: opencv-python
Requires-Dist: pip-chill
Requires-Dist: pyqt5
Requires-Dist: pyyaml
Requires-Dist: scikit-image>=0.26.0
Requires-Dist: scikit-learn
Requires-Dist: seaborn
Requires-Dist: seaborn-image
Requires-Dist: send2trash
Requires-Dist: tomli
Requires-Dist: torch
Requires-Dist: tqdm
Requires-Dist: twine
Requires-Dist: imageio-ffmpeg
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

[//]: # (# CABANA - Collagen Fibre Analyzer)
![image](cabana.png)
[![PyPI version](https://badge.fury.io/py/cabana.svg)](https://pypi.org/project/cabana/0.0.1/)
[![Documentation Status](https://readthedocs.org/projects/cabana/badge/?version=latest)](https://cabana.readthedocs.io/en/latest/?badge=latest)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

CABANA (CollAgen FiBre ANAlyzer) is a comprehensive toolkit for analyzing collagen fibre architecture in immunohistochemistry (IHC) and fluorescence microscopy images. It provides:

- Automated detection and quantification of collagen fibres
- Analysis of fibre orientation, length, and thickness
- Gap analysis for inter-fibre and intra-fibre spaces
- Interactive parameter optimization interface
- Batch processing for large datasets

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.

## System Requirements

- **Processor (CPU):** Intel Core i7, AMD Ryzen 7, or higher recommended
- **Memory (RAM):** Minimum 16 GB, 32 GB recommended
- **GPU:** NVIDIA GeForce GTX/RTX series with at least 10 GB VRAM recommended
- **Python:** 3.8 or newer


## Quick Installation

Install CABANA using pip:

```bash
pip install -U cabana
```
or install the latest version on GitHub:

```bash
pip install git+https://github.com/lxfhfut/Cabana.git
```

After installation, you can launch the CABANA GUI by running:

```bash
python -m cabana
```

Alternatively, you can import CABANA in your Python code for customized analysis (**see examples in Tutorials**):

```python
import cabana
```

## Documentation

Comprehensive documentation is available at:
[https://cabana.readthedocs.io/en/latest/](https://cabana.readthedocs.io/en/latest/)

## Tutorials

We provide an interactive Jupyter notebook tutorial to help you get started:
[CABANA Tutorial](https://cabana.readthedocs.io/en/latest/_static/tutorial.ipynb)

## Citation

If you use CABANA in your research, please cite:
<!--
```
Magenau A, et al. (2025). CABANA: A comprehensive toolkit for collagen fibre analysis in biomedical imaging. Journal of XYZ. DOI: XYZ
```-->

## License

CABANA is released under the MIT License.

## Contact

For questions and support, please contact:
- Xufeng Lin - <x.lin@garvan.org.au>
- Astrid Magenau - <a.magenau@garvan.org.au>
