Skip to content

A Slicer extension to provide a GUI around pyradiomics

License

Notifications You must be signed in to change notification settings

AIM-Harvard/SlicerRadiomics

Folders and files

NameName
Last commit message
Last commit date

Latest commit

8426cdf · Apr 25, 2024
Oct 17, 2022
Jun 2, 2019
Jan 7, 2024
Apr 30, 2018
Jun 17, 2022
Mar 9, 2017
Mar 9, 2017
Apr 25, 2024
Dec 2, 2016
Jan 24, 2018
Nov 27, 2019
Mar 16, 2022
Apr 28, 2017

Repository files navigation

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:

  • Clone the source code of the repository.
$ git clone https://github.com/radiomics/SlicerRadiomics.git
  • Create an empty directory for building the extension.
$ mkdir SlicerRadiomics-build
  • Configure the build using cmake.
$ cd SlicerRadiomics-build
$ cmake -DSlicer_DIR:PATH=/path/to/Slicer-Release/Slicer-build ../SlicerRadiomics
  • Build the extension.
$ 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

  • Specify additonal launcher setting and module path.
cd SlicerRadiomics-build/inner-build/
build_dir=$pwd

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

Package, install and restart Slicer

  • Package the extension.
$ cd inner-build
$ make package
  • Once completed, you can install the extension from file.

  • Restart Slicer and open SlicerRadiomics module.

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).