Skip to content

Extranodal Extension (ENE) Identification on Computed Tomography with Deep Learning for Head and Neck Cancers

License

Notifications You must be signed in to change notification settings

bhkann/DualNet-ENE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DualNet-ENE

Extranodal Extension (ENE) Identification on Computed Tomography with Deep Learning for Head and Neck Cancers arXiv

Keywords: Deep Learning, Convolutional Neural Network, CT, Head and Neck, Cancer, extranodal extension

This work is under review, and citation will be available upon publication. Source code for the manuscript is now viewable in this repository. A fully usable, reproducible, open-access pipeline with trained model will be made available via www.modelhub.ai upon publication. Link will be included here.

Introduction

Extranodal extension (ENE) occurs when tumor infiltrates through the lymph node capsule in the surrounding tissue. In head and neck cancer, ENE is an important factor for prognostication and treatment decision-making for head and neck cancer. ENE can only be diagnosed on surgical pathology, and it is very difficult for radiologists to predict ENE based on CT scans. DualNet-ENE is a deep learning, 3D-CNN model that has been trained on multi-institutional datasets of pathologically-annotated lymph nodes to accurately and reliably predict nodal metastasis and ENE (Kann et al, Scientific Reports, 2018, Kann et al, Journal of Clinical Oncology, 2020). DualNet-ENE accepts a head and neck CT scan and a manually segmented lymph node mask as input. It outputs the probability of extranodal extension and nodal metastasis at the lymph node-level.

Repository Structure

The DualNet-ENE repository is structured as follows:

  • All the source code to reproduce the deep-learning-based pipeline is found under the src folder.
  • Upon manuscript publication (currently under review), the model will be uploaded and hosted open-access on www.modelhub.ai
  • Five sample subjects' CT data and the associated manual node segmentation masks as well as all the models weights necessary to run the pipeline will be included for experimental pipeline testing

Setup

This code was developed and tested using Python 3.8.5 on Ubuntu 20.04 with Cuda 11.2 and Tensorflow version 2.4

For the code to run as intended, all the packages under requirements.txt should be installed. In order not to break previous installations and ensure full compatibility, it's highly recommended to create a virtual environment to run the DeepCAC pipeline in. Here follows an example of set-up using python virtualenv:

# install python's virtualenv
sudo pip install virtualenv

# parse the path to the python3 interpreter
export PY3PATH=$(which python3)

# create a virtualenv with such python3 interpreter named "venv"
# (common name, already found in .gitignore)
virtualenv -p $PY3PATH venv 

# activate the virtualenv
source venv/bin/activate

At this point, (venv) should be displayed at the start of each bash line. Furthermore, the command which python3 should return a path similar to /path/to/folder/venv/bin/python3. Once the virtual environment is activated:

# once the virtualenv is activated, install the dependencies
pip install -r requirements.txt

At this stage, everything should be ready for the data to be processed by the pipeline. Additional details can be found in the markdown file under src.

The virtual environment can be deactivated by running:

deactivate

Disclaimer

The code and data of this repository are provided to promote reproducible research. They are not intended for clinical care or commercial use.

The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.

About

Extranodal Extension (ENE) Identification on Computed Tomography with Deep Learning for Head and Neck Cancers

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages