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
- Tissue micro-array (TMA) preprocessing: native Olympus VSI reading, core fitting, per-core images and masks named by patient (
cabana-tma) - Optional ROI masks that confine every measurement to a region of interest
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.12
- Apple silicon: the segmentation network runs on the Apple GPU (MPS) automatically
Quick Installation
Install CABANA using pip:
pip install -U cabana
or install the latest version on GitHub:
pip install git+https://github.com/lxfhfut/Cabana.git
After installation, you can launch the CABANA GUI by running:
python -m cabana # or: cabana-gui
Tissue micro-array slides can also be cut into per-core images from the command line:
cabana-tma "APGI TMA 1 PicRed.vsi" out/TMA1 --array 1 # built-in ICGC/APGI array
cabana-tma "my slide.vsi" out/mine --map my_maps.csv # your own map
cabana-tma map template maps/ # a template to type or paste a map into
Alternatively, you can import CABANA in your Python code for customized analysis (see the Python API page):
from cabana import Cabana, BatchProcessor, TMAPreprocessor
Documentation
Comprehensive documentation is available at: https://cabana.readthedocs.io/en/latest/
Tutorials
We provide an interactive Jupyter notebook tutorial to help you get started: CABANA Tutorial
Citation
If you use CABANA in your research, please cite:
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
1 maintainer
Metadata
1 maintainer
Release files for cabana 0.3.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cabana-0.3.7.tar.gz | 382.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cabana-0.3.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 716.6 kB
Release files / cabana-0.3.7.tar.gz
| Download URL | cabana-0.3.7.tar.gz |
|---|---|
| Size | 382.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1271b8bad01e6d28e0302a5cd8b00ebc1ae8c7615ef73e78e514e54d1e663560
|
|
BLAKE2b-256 checksum How to use checksums |
912753c6278c3bac159de2a147dca8adc2c42bff8d34fefee00e53c7912e026f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.11
|
Release files / cabana-0.3.7-py3-none-any.whl
| Download URL | cabana-0.3.7-py3-none-any.whl |
|---|---|
| Size | 334.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
db2391fee823ddc48d108bdae8e6f079a585a71d4490304305cd813fcc47aa77
|
|
BLAKE2b-256 checksum How to use checksums |
f0d1fd2834c383b871b210590a4cb3c35c1770fd924b340eea0b3ade98eb4a07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.11
|
