Skip to content

MICAI-IMI-UzL/LNQ2023

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LNQ Challenge 2023: Learning Mediastinal Lymph Node Segmentation with a Probabilistic Lymph Node Atlas

This repository presents the code used for participation in the LNQ 2023 challenge hosted at MICCAI 2023.

Our approach consists of a preprocessing step, the network training and a postprocessing of the predicted results. In the pre-processing, automatic segmentation of anatomical structures and atlas-to-patient registration is performed to generate strong anatomical priors. We have used the LNQ2023 train dataset as well as public datasets provided by Roth et al. (2014) with refined annotations and Bouget et al. (2020) as training data. nnU-Net serves as segmentation network architecture.

Inference Instructions

Download the model weights and the probabilistic lymph node atlas from IMI Cloud. Unpack weights.zip under Inference and run the Dockerfile.

Train Instructions

For training the nnU-Net, we need to create three folders: nnUNet_raw, nnUNet_preprocessed and nnUNet_results (see: nnUNet dataset formatting).

1. Preprocessing

1.1 Create nnUNet raw

Our preprocessing code, provided in Inference, stores preprocessed images in patient-specific folders. The resulting images need to be copied in nnUNet_raw. The dataset.json file stored within nnUNet_raw needs to look like this:

{ 
 "channel_names": {
   "0": "CT",
   "1": "noNorm",
   "2": "rgb_to_0_1"
 }, 
 "labels": {
   "background": 0,
   "LN": 1
 }, 
 "numTraining": 512, 
 "file_ending": ".nii.gz"
 }

1.2 Run nnU-Net preprocessing

To start nnU-Net preprocessing replace XX with the correct dataset number and run this command:

nnUNetv2_plan_and_preprocess -d XX --verify_dataset_integrity -pl ResEncUNetPlanner -c 3d_fullres

2. Training

First, set the environment variables accoring to nnUNet set environment variables. Second, run the training script providing the required arguments.

3. Postprocessing

The code for postprocessing can be also found in Inference.

Reference and Citation

Please refer to our work:

Sofija Engelson, Jan Ehrhardt, Timo Kepp, Joshua Niemeijer, Heinz Handels (2024). “LNQ Challenge 2023: Learning Mediastinal Lymph Node
Segmentation with a Probabilistic Lymph Node Atlas." In submission.

BibTex citation:

@article{lnq2023,
  title={LNQ Challenge 2023: Learning Mediastinal Lymph Node Segmentation with a Probabilistic Lymph Node Atlas},
  author={Engelson, Sofija and Ehrhradt, Jan and Kepp, Timo and Niemeijer, Joshua and Handels, Heinz},
  year={2024},
}

License

See the LICENSE.txt file for license rights and limitations (CC BY-NC-ND 4.0).

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published