Commit 67f4f876 authored by Alessia Marcolini's avatar Alessia Marcolini
Browse files

Add conda environment configuration file + update README with setup steps

parent 3903899f
......@@ -10,7 +10,32 @@ Repository attached to the paper "Multimodal learning for prognosis prediction i
In this study, we introduce a machine learning framework for medical imaging that combines the current pattern recognition approach ("radiomics") with Deep Learning (DL). We apply the framework in cancer bioimaging for prognosis of locoregional recurrence in head and neck squamous cell carcinoma (N=298) from Computed Tomography (CT) and Positron Emission Tomography (PET) imaging. The DL architecture is composed of two parallel cascades of Convolutional Neural Network (CNN) layers merging in a softmax classification layer. The network is first pretrained on head and neck tumor stage diagnosis, then fine-tuned on the prognostic task by internal transfer learning. In parallel, radiomics features (e.g., shape of the tumor mass, texture and pixels intensity statistics) are derived by predefined feature extractors on the PET-CT pairs. We first compare and then mix deep learning and radiomics features into a unifying classification pipeline (RADLER), where model selection and evaluation are based on a data analysis plan developed in the MAQC initiative for reproducible biomarkers. On the multimodal PET-CT cancer dataset, the mixed deep learning/radiomics approach is more accurate than using only one feature type, or image mode. Further, RADLER significantly improves over published results on the same data.
## Pretrained models
We share the weights of the models, as described in the manuscript. See folder [pretrained_weights](pretrained_weights).
## Setup
```bash
git clone https://gitlab.fbk.eu/mpba-radiomics/RADLER
cd RADLER
conda env create -f env.yml -n radler
conda activate radler
```
### Additional dependencies
#### MLPY
`mlpy` package is required for some operations included in the DAP procedure.
The `mlpy` package available on PyPI is outdated and not working on OSX platforms.
These are the steps to follow:
Let `<ANACONDA>` be your anaconda path (e.g., `/home/user/anaconda3`).
Adjust these environmental variables:
```bash
export LD_LIBRARY_PATH=<ANACONDA>/envs/<ENV>/lib:${LD_LIBRARY_PATH}
export CPATH=<ANACONDA>/envs/<ENV>/include:${CPATH}
```
and then install `mlpy` from GitLab:
```bash
pip install git+https://gitlab.fbk.eu/MPBA/mlpy.git
```
## Pretrained models
We share the weights of the models, as described in the manuscript. See folder [pretrained_weights](pretrained_weights).
\ No newline at end of file
name: radler
channels:
- conda-forge
- defaults
- radiomics
dependencies:
- python
- pyradiomics=2.0
- pandas
- tqdm
- xlrd
- simpleitk
- pytorch
- torchvision
- cudatoolkit=10.1
- scikit-learn
- matplotlib
- gsl
prefix: /home/utente/anaconda3/envs/radler
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment