CoLlAGe captures subtle anisotropic differences in disease pathologies by measuring entropy of co-occurrences of voxel-level gradient orientations on imaging computed within a local neighborhood. CoLlAGe is based on the hypothesis that disruption in tissue microarchitecture can be quantified on imaging by measuring the disorder in voxel-wise gradient orientations. CoLlAGe involves assigning every image voxel a ‘disorder value’ associated with the co-occurrence matrix of gradient orientations computed around every voxel. Details on extraction of CoLlAGe features are included in [1]. After feature extraction, the subsequent distribution or different statistics such as mean, median, variance etc can be computed and used in conjunction with a machine learning classifier to distinguish similar appearing pathologies. The feasibility of CoLlAGe in distinguishing cancer from treatment confounders/benign conditions and characterizing molecular subtypes of cancers has been demonstrated in the context of multiple challenging clinical problems.
Currently supports the following Haralick features:
- AngularSecondMoment
- Contrast
- Correlation
- SumOfSquareVariance
- SumAverage
- SumVariance
- SumEntropy
- Entropy
- DifferenceVariance
- DifferenceEntropy
- InformationMeasureOfCorrelation1
- Both interpretations.
- InformationMeasureOfCorrelation2
- MaximalCorrelationCoefficient
collageradiomics includes parameter tuning information in the output. It contains the image(s) and mask(s), and the settings applied upon them. This allows multiple fully reproducible runs without having to remember or find the original parameters.
The best source of documentation is found the examples-- instructions provided below.
pip install collageradiomics
git clone https://github.com/ccipd/collageradiomics && cd collageradiomics
- Install Docker.
- Pull the latest image:
docker pull radiomics/collageradiomics-examples:latest
- Run one of these commands in the root of git repository:
docker run -it -p 8888:8888 -v $PWD:/root ccipd/collageradiomics-examples
docker run -it -p 8888:8888 -v ${PWD}:/root ccipd/collageradiomics-examples
localhost:8888
Open jupyter/examples directory and explore the Jupyter notebooks.
This is a Docker image with the collageradiomics module pre-installed:
docker pull radiomics/collageradiomics-pip:latest
docker run -it -p 8888:8888 ccipd/collageradiomics-pip
collageradiomics can be implemented in Python through the collageradiomics module. It has a intuitive interface-- simply create a Collage object or use one of the factory methods and run the execute() function.
We thank these generous developers that allowed us to build collageradiomics without reinventing the wheel:
- matplotlib
- numpy
- scikit-learn
- scikit-build
- mahotas
- scipy
If you make use of this implementation, please cite the following paper:
[1] Prasanna, P., Tiwari, P., & Madabhushi, A. (2016). Co-occurrence of Local Anisotropic Gradient Orientations (CoLlAGe): A new radiomics descriptor. Scientific Reports, 6:37241.
Please report any issues or feature requests via the Issues tab
Additional information can be found on the BrIC Lab website.