Skip to main content

Jupyter widgets to visualize images in 2D and 3D

Project description

License PyPI Build status https://mybinder.org/badge.svg

Interactive Jupyter widgets to visualize images in 2D and 3D.

itk-jupyter-widgets chest CT in JupyterLab

These widgets are designed to support image analysis with the Insight Toolkit (ITK), but they also work with other spatial analysis tools in the scientific Python ecosystem.

These widgets are built on itk.js and vtk.js.

itk-jupyter-widgets demo

Installation

To install the widgets for the Jupyter Notebook:

pip install itkwidgets

For Jupyter Lab, additionally run:

jupyter labextension install @jupyter-widgets/jupyterlab-manager itk-jupyter-widgets

Examples

After installation, try the following examples that demonstrate how to visualize:

or how to:

Examples on Binder

Data types:

Tasks:

Troubleshooting

If you experience the notebook warning:

IOPub data rate exceeded.
The notebook server will temporarily stop sending output
to the client in order to avoid crashing it.
To change this limit, set the config variable
`--NotebookApp.iopub_data_rate_limit`.

Set the notebook configuration value:

jupyter notebook --NotebookApp.iopub_data_rate_limit=1e12

Hacking

For a development installation (requires Node.js):

git clone https://github.com/InsightSoftwareConsortium/itk-jupyter-widgets.git
cd itk-jupyter-widgets
python -m pip install -r requirements-dev.txt -r requirements.txt
python -m pip install -e .
jupyter nbextension install --py --symlink --sys-prefix itkwidgets
jupyter nbextension enable --py --sys-prefix itkwidgets
jupyter nbextension enable --py --sys-prefix widgetsnbextension
python -m pytest

The above commands will setup your system for development with the Jupyter Notebook. To develop for Jupyter Lab, additionally run:

jupyter labextension install @jupyter-widgets/jupyterlab-manager
jupyter labextension install ./js

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

itkwidgets-0.12.2.tar.gz (2.0 MB view details)

Uploaded Source

Built Distribution

itkwidgets-0.12.2-py2.py3-none-any.whl (3.6 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file itkwidgets-0.12.2.tar.gz.

File metadata

  • Download URL: itkwidgets-0.12.2.tar.gz
  • Upload date:
  • Size: 2.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.5

File hashes

Hashes for itkwidgets-0.12.2.tar.gz
Algorithm Hash digest
SHA256 67a39fffbf56bf61d1950d8575e378987daf90125e14fed127c17434453ef60b
MD5 997dfbd8fcb6dcc551a70d37188620fa
BLAKE2b-256 85e5b3d4f089ec02063097dae2c5121169fb65651d2d88374aef85270d762e1d

See more details on using hashes here.

File details

Details for the file itkwidgets-0.12.2-py2.py3-none-any.whl.

File metadata

  • Download URL: itkwidgets-0.12.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 3.6 MB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.5

File hashes

Hashes for itkwidgets-0.12.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 c86b49890f9bcbc8e86739b4828a940274c7ee4e7e0e0c29792b3cb79e679c90
MD5 064e3395eb4b4e64a2d02598a1ff341b
BLAKE2b-256 e17218b12e99f2cf2655d2290c32624217d228629b87c3fa7efd99934c4ca9bd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page