{"id":13935034,"url":"https://github.com/InsightSoftwareConsortium/SimpleITK-Notebooks","last_synced_at":"2025-07-19T19:33:48.647Z","repository":{"id":6256707,"uuid":"7489426","full_name":"InsightSoftwareConsortium/SimpleITK-Notebooks","owner":"InsightSoftwareConsortium","description":"Jupyter notebooks for learning how to use SimpleITK","archived":false,"fork":false,"pushed_at":"2025-06-02T18:14:07.000Z","size":116860,"stargazers_count":865,"open_issues_count":15,"forks_count":354,"subscribers_count":46,"default_branch":"master","last_synced_at":"2025-07-09T14:48:26.092Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/InsightSoftwareConsortium.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-01-07T20:37:52.000Z","updated_at":"2025-06-30T06:44:33.000Z","dependencies_parsed_at":"2023-09-26T06:57:19.853Z","dependency_job_id":"a62b0d36-aa85-4729-be5a-cd3c79d2be1b","html_url":"https://github.com/InsightSoftwareConsortium/SimpleITK-Notebooks","commit_stats":{"total_commits":501,"total_committers":19,"mean_commits":26.36842105263158,"dds":0.343313373253493,"last_synced_commit":"d63e60d28e023d3a223d3a3eecd90f8dfdb7ecde"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/InsightSoftwareConsortium/SimpleITK-Notebooks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InsightSoftwareConsortium%2FSimpleITK-Notebooks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InsightSoftwareConsortium%2FSimpleITK-Notebooks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InsightSoftwareConsortium%2FSimpleITK-Notebooks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InsightSoftwareConsortium%2FSimpleITK-Notebooks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/InsightSoftwareConsortium","download_url":"https://codeload.github.com/InsightSoftwareConsortium/SimpleITK-Notebooks/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/InsightSoftwareConsortium%2FSimpleITK-Notebooks/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265230446,"owners_count":23731374,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-07T23:01:21.861Z","updated_at":"2025-07-19T19:33:43.638Z","avatar_url":"https://github.com/InsightSoftwareConsortium.png","language":"Jupyter Notebook","readme":"# SimpleITK Notebooks\n\n![GitHub Actions Notebook Testing](https://github.com/InsightSoftwareConsortium/SimpleITK-Notebooks/workflows/GitHub%20Actions/badge.svg)\u0026nbsp;\u0026nbsp;[![CircleCI Notebook Testing](https://dl.circleci.com/status-badge/img/gh/InsightSoftwareConsortium/SimpleITK-Notebooks/tree/master.svg?style=shield)](https://dl.circleci.com/status-badge/redirect/gh/InsightSoftwareConsortium/SimpleITK-Notebooks/tree/master)\n\u0026nbsp;\u0026nbsp;[![http://insightsoftwareconsortium.github.io/SimpleITK-Notebooks/](https://img.shields.io/website-up-down-green-red/http/shields.io.svg)](http://insightsoftwareconsortium.github.io/SimpleITK-Notebooks/)\n\u0026nbsp;\u0026nbsp;[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n\n[SimpleITK](https://itk.org/Wiki/SimpleITK) is an abstraction layer and wrapper around the Insight Segmentation and Registration Toolkit [(ITK)](http://www.itk.org). It is available in the following programming languages: C++, Python, R, Java, C#, Lua, Tcl and Ruby.\n\nThis repository contains a collection of Jupyter Notebooks illustrating the use of SimpleITK for educational and research activities. The notebooks demonstrate the use of SimpleITK for interactive image analysis using the Python and R programming languages.\n\nThe repository and its contents can be used for:\n1. Learning SimpleITK.\n2. As a basis for your teaching activities.\n3. As a basis for your research activities.\n\nFor the latter two use cases you can take advantage of the the repository's infrastructure which supports remote data downloads and notebook testing. These readily facilitate collaborative research.\n\nThe animation below is a visualization of a rigid CT/MR registration process\ncreated with SimpleITK and Python (the [script](Utilities/intro_animation.py) used to generate the frames for the animated gif is found in the repository's Utilities directory).\n\n![](registration_visualization.gif)\n\n# Getting Started\n\nNote that currently SimpleITK with R is only available on Linux and Mac.\n\n1. Language specific details for installing the notebooks is given in the README files in the respective directories ([Python](Python/README.md), [R](R/README.md)). For general information about installing SimpleITK please see the [SimpleITK read-the-docs](https://simpleitk.readthedocs.io/en/master/) pages.\n\n2. The [SimpleITK API documentation](https://simpleitk.org/doxygen/latest/html/index.html) is based on the C++ implementation which is readily mapped to your language of choice.\n\n3. Learn the general concepts underlying the implementations of segmentation and registration by reading the ([ITK book](https://itk.org/ItkSoftwareGuide)). 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).     \n\n4. General notebook setup. By default the contents of the Jupyter notebooks do not occupy the full browser window width. To take advantage of the full window width you can either configure each notebook independently by adding the following into a code cell:\n```\nfrom IPython.core.display import display, HTML\ndisplay(HTML(\"\u003cstyle\u003e.container { width:100% !important; }\u003c/style\u003e\"))\n```\nOr apply this configuration to all notebooks by adding the following to\nthe custom.css jupyter configuration file:\n```\n.container { width:100% !important; }\n```\nOn OSX/Linux this file is found in `~/.jupyter/custom/custom.css` on windows it is\nfound in `C:\\Users\\[your_user_name]\\.jupyter\\custom\\custom.css`.\n\n# Kicking the Tires\n\nBefore you clone the repository to your computer you may want to try it out, kick the tires so to speak.\n\nThanks to the awesome people from the [Binder Project](https://github.com/jupyterhub/binderhub)\nyou can try out the Python notebooks without installing a thing.\n\nSome caveats:\n\n1. This is a free public service with limited resources, so may not always be available.\n2. Some of our notebooks require significant computational\n   resources which may not be available.\n3. All cells that use the sitk.Show() command will generate an exception because they\n   require a Fiji installation. Either ignore this or modify the code\n   for the session.\n\nAfter you launch binder, go to the Python directory and select the notebook of interest:\n\n[![Binder](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/InsightSoftwareConsortium/SimpleITK-Notebooks/master)\n\n# Contributions from the Community\n\nWe encourage contributions from the community!!!\n\n1. Ask questions on the [ITK discourse](https://discourse.itk.org/).\n2. Report issues you encounter (compatibility/bugs) using the\n   [GitHub issue reporting system](https://guides.github.com/features/issues/).\n2. Contribute code ([instructions](CONTRIBUTING.md)):\n   1. bug fixes.\n   2. improved versions of existing notebooks, both text and code.\n   3. new notebooks.\n\n# How to Cite\n\nIf you find these notebooks or the notebook testing infrastructure useful in your research, support our efforts by citing it as:\n\nZ. Yaniv, B. C. Lowekamp, H. J. Johnson, R. Beare, \"SimpleITK Image-Analysis Notebooks: a Collaborative Environment for Education and Reproducible Research\", J Digit Imaging., https://doi.org/10.1007/s10278-017-0037-8, 31(3): 290-303, 2018.\n","funding_links":[],"categories":["Jupyter Notebook"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FInsightSoftwareConsortium%2FSimpleITK-Notebooks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FInsightSoftwareConsortium%2FSimpleITK-Notebooks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FInsightSoftwareConsortium%2FSimpleITK-Notebooks/lists"}