dmwelch / SimpleITK-Notebooks

Jupyter notebooks for learning how to use SimpleITK

SimpleITK Notebooks

SimpleITK is an abstraction layer and wrapper around the Insight Segmentation and Registration Toolkit (ITK). It is available in the following programming languages: C++, Python, R, Java, C#, Lua, Tcl and Ruby.

This repository contains a collection of Jupyter Notebooks, designed for tutorials and presentations. The notebooks demonstrate the use of SimpleITK for interactive image analysis using the Python and R programming languages.

The animation below is a visualization of a rigid CT/MR registration process created with SimpleITK and Python (the script used to generate the frames for the animated gif is found in the repository's Utilities directory).

Getting Started

Note that currently SimpleITK with R is only available on Linux and Mac.

1. Language specific details for installing the notebooks is given in the README files in the respective directories (Python, R). For general information about installing SimpleITK please see the SimpleITK wiki.

2. The SimpleITK API documentation is based on the C++ implementation which is readily mapped to your language of choice.

3. Learn the general concepts underlying the implementations of segmentation and registration by reading the (ITK book). The relevant portion is "Book 2: Design and Functionality". The ITK API is significantly different from the SimpleITK one, but the general concepts are the same (e.g. combination of optimizer and similarity metric for registration).

Contributions from the Community

We encourage contributions from the community!!!

1. Report issues you encounter (compatibility/bugs) using the GitHub issue reporting system.
2. Contribute:
   1. bug fixes.
   2. improved versions of existing notebooks, both text and code.
   3. new notebooks.

Just follow the standard GitHub workflow.