Jupyter widgets to visualize images in 2D and 3D
Project description
Interactive Jupyter widgets to visualize images in 2D and 3D.
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.
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:
ImageJ ImgLib2 images (requires conda and a local Fiji installation)
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
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 67a39fffbf56bf61d1950d8575e378987daf90125e14fed127c17434453ef60b |
|
MD5 | 997dfbd8fcb6dcc551a70d37188620fa |
|
BLAKE2b-256 | 85e5b3d4f089ec02063097dae2c5121169fb65651d2d88374aef85270d762e1d |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | c86b49890f9bcbc8e86739b4828a940274c7ee4e7e0e0c29792b3cb79e679c90 |
|
MD5 | 064e3395eb4b4e64a2d02598a1ff341b |
|
BLAKE2b-256 | e17218b12e99f2cf2655d2290c32624217d228629b87c3fa7efd99934c4ca9bd |