Home

Awesome

About

SlicerRadiomics is an extension for 3D Slicer that encapsulates pyradiomics library that calculates a variety of radiomics features.

See list and detailed description of computed features in pyradiomics library documentation.

Install instructions

SlicerRadiomics is currently distributed as an extension via the 3D Slicer ExtensionManager. Follow these steps to install the extension:

  1. Download the latest nightly release for your platform from http://download.slicer.org. Do NOT use installers tagged as "Stable Release"! If you use Mac, make sure you move the Slicer application to the Applications folder on your computer before launching it!
  2. Once installed, open Extension Manager by clicking the icon as shown below.
  3. Search for Radiomics and install the extension by clicking the INSTALL button.
  4. Once installation of Radiomics and dependencies is completed, you will need to restart Slicer application to access the module. If installation was successful, you should be able to see Radiomics module in the Slicer module list.

Building SlicerRadiomics from source

In order to build this extension, you need to have a version of Slicer built from source. You can build Slicer following the instructions. Once you have done that, all you need to do are the following steps:

$ git clone https://github.com/radiomics/SlicerRadiomics.git
$ mkdir SlicerRadiomics-build
$ cd SlicerRadiomics-build
$ cmake -DSlicer_DIR:PATH=/path/to/Slicer-Release/Slicer-build ../SlicerRadiomics
$ make

Note: cmake is one of the prerequisites for building 3D Slicer

Loading SlicerRadiomics from a build tree

There are two options:

Start Slicer specifying command-line options

cd SlicerRadiomics-build/inner-build/
build_dir=$pwd

./Slicer \
  --launcher-additional-settings $build_dir/AdditionalLauncherSettings.ini \
  --additional-module-path $build_dir

Package, install and restart Slicer

$ cd inner-build
$ make package

Support

If you found a bug, or to report a reproducible problem, submit an issue.

If you have a question about using the extension, please ask on the Radiomics community section of the 3D Slicer Discourse.

Acknowledgments

This project is supported in part by the National Institutes of Health, National Cancer Institute Informatics Technology for Cancer Research (ITCR) program via grant U24 CA194354 (PI Hugo Aerts).