This is the official Slicer Extension for uniGradICON
: A Foundation Model for Medical Image Registration, and multiGradICON
: A Foundation Model for Multimodal Medical Image Registration. The extension provides a Slicer interface for the models, allowing users to perform image registration tasks using the models. The official repository for the models can be found here.
uniGradICON: A Foundation Model for Medical Image Registration
Tian, Lin and Greer, Hastings and Kwitt, Roland and Vialard, Francois-Xavier and Estepar, Raul San Jose and Bouix, Sylvain and Rushmore, Richard and Niethammer, Marc
MICCAI 2024 https://arxiv.org/abs/2403.05780
multiGradICON: A Foundation Model for Multimodal Medical Image Registration
Demir, Basar and Tian, Lin and Greer, Thomas Hastings and Kwitt, Roland and Vialard, Francois-Xavier and Estepar, Raul San Jose and Bouix, Sylvain and Rushmore, Richard Jarrett and Ebrahim, Ebrahim and Niethammer, Marc
MICCAI Workshop on Biomedical Image Registration (WBIR) 2024 https://arxiv.org/abs/2408.00221
Please (currently) cite as:
@article{tian2024unigradicon,
title={uniGradICON: A Foundation Model for Medical Image Registration},
author={Tian, Lin and Greer, Hastings and Kwitt, Roland and Vialard, Francois-Xavier and Estepar, Raul San Jose and Bouix, Sylvain and Rushmore, Richard and Niethammer, Marc},
journal={arXiv preprint arXiv:2403.05780},
year={2024}
}
@article{demir2024multigradicon,
title={multiGradICON: A Foundation Model for Multimodal Medical Image Registration},
author={Demir, Basar and Tian, Lin and Greer, Thomas Hastings and Kwitt, Roland and Vialard, Francois-Xavier and Estepar, Raul San Jose and Bouix, Sylvain and Rushmore, Richard Jarrett and Ebrahim, Ebrahim and Niethammer, Marc},
journal={arXiv preprint arXiv:2408.00221},
year={2024}
}
To install the extension, clone this repository using the following command:
git clone https://github.com/uncbiag/SlicerUniGradICON.git
Then, build the extension using the Slicer Extension Wizard which can be found under Modules -> Developer Tools -> Extension Wizard. Click on the "Select extension" button and select the cloned repository folder. It will automatically detect the extension and it will be appear under the Modules -> Registration menu.
-
Initially, select the fixed and moving images, and their modality (MR or CT/CBCT). The extension will preprocess the images based on the selected modality. The user does not need to perform any preprocessing steps manually.
-
The extension provides two models:
uniGradICON
andmultiGradICON
. Both models have the same interface and can be used to perform image registration tasks. The user can select the desired model from a drop-down menu. -
Additionally, the user can specify the number of iterations for the optimization (IO steps) process. The default value is set to 0 iterations. However, we recommend using at least 50 iterations for more challenging registration tasks.
-
The user can also select the similarity loss function that will be used during the optimization process. The available similarity losses are:
- Localized Normalized Cross-Correlation (LNCC)
- Squared Localized Normalized Cross-Correlation (Squared LNCC)
- Modality Independent Neighborhood Descriptor (MIND - SSC)
For multimodal registration tasks, we recommend using the Squared LNCC or MIND - SSC similarity loss. Note that if IO steps are set to 0, the selected similarity loss function will not be applied.
-
Finally, the user can select the output transform and transformed image. These will be saved under the specified names in the Slicer scene.
-
After selecting all necessary parameters, the user can click the "Run Registration" button to initiate the registration process. The extension will perform the task using the selected model and parameters. Depending on the selected parameters and CUDA availability, the process may take a few minutes.
-
The user can visualize the registration results by selecting the output transform and transformed image under the "Data" module. Also, we recommend using the "CheckerBoard Filter" module to compare the registration result with the fixed image.
This implementation is based on the SlicerANTs and SlicerSegmentWithSAM repositories. We thank the authors for their work.