If you encounter problems or have tutorial specific questions, please post on
the tutorial's GitHub issue
reporting system (requires a GitHub user account). For general SimpleITK questions, please
use the ITK discourse forum.
Overview
SimpleITK is a simplified programming
interface to the algorithms and data
structures of the Insight Toolkit (ITK) for
segmentation, registration and
advanced image analysis. It supports bindings for multiple programming languages
including C++, Python, R, Java, C#, Lua, Ruby and TCL. Combining SimpleITK’s
Python bindings with the Jupyter
notebook web application creates an environment
which facilitates collaborative development of biomedical image analysis
workflows.
In this tutorial, we use a hands-on approach utilizing Python and Jupyter notebooks to
explore and experiment with various SimpleITK features. You can browse the Jupyter notebooks on
your own, watch the videos associated with these notebooks or work your way through the notebooks
following along with the videos.
Additional details and notebooks can be found on the main SimpleITK
notebooks repository.
Setup
In this tutorial we will use the Anaconda Python distribution. Please follow the
instructions below to setup the environment. All
commands below are issued on the command line (Linux/Mac - terminal,
Windows - Anaconda Prompt).
-
Download and install the Fiji image viewer. This is the default image viewer used by SimpleITK:
-
On Windows: Install into your user directory (e.g. C:\Users\[your_user_name]\).
-
On Linux: Install into ~/bin/ .
-
On Mac: Install into /Applications/ or ~/Applications/ .
-
Download and install the most
recent version of Anaconda for your operating system. We assume it is installed
in a directory named anaconda3. Regardless of the installer, we will be working
with Python 3.8
-
- On Windows: open the Anaconda Prompt (found under the Anaconda3 start menu).
- On Linux/Mac: on the command line
source path_to_anaconda3/bin/activate base
-
Update the base anaconda environment and install the git version control system into it.
conda update conda
conda update anaconda
conda install git
-
Clone this repository:
git clone https://github.com/SimpleITK/TUTORIAL.git
-
Create the virtual environment containing all packages required for the course:
conda env create -f TUTORIAL/environment.yml
-
Activate the virtual environment:
- On Windows: open the Anaconda Prompt (found under the Anaconda3 start menu)
conda activate sitkpy
- On Linux/Mac: on the command line
source path_to_anaconda3/bin/activate
sitkpy
Tutorial
Click the launch binder button to try things out without installing
, some display functions that use an external
viewer will not work.
Support the Toolkit
Star us on GitHub (requires GitHub account):
If you find that SimpleITK has been useful in your research, cite the appropriate paper (citations.bib):
-
R. Beare, B. C. Lowekamp, Z. Yaniv, "Image Segmentation, Registration and Characterization in R with SimpleITK", J Stat Softw, 86(8), 2018.
-
Z. Yaniv, B. C. Lowekamp, H. J. Johnson, R. Beare, "SimpleITK Image-Analysis Notebooks: a Collaborative Environment for
Education and Reproducible Research", J Digit Imaging., 31(3): 290-303, 2018.
-
B. C. Lowekamp, D. T. Chen, L. Ibáñez, D. Blezek, "The Design of SimpleITK", Front. Neuroinform., 7:45., 2013.
|