# User Guide ## Notebooks Since July 2022, ITK Viewer Bootstrap UI is the default UI for ITKWidgets-1.0. However, you can control the UI by passing the `ui` argument to the view function: For the reference UI: ``` view(image, ui='reference') ``` For the material UI: ``` view(image, ui='mui') ``` For more information about ITKWidgets 1.0, please visit the [documentation website](https://itkwidgets.readthedocs.io/en/latest/index.html). ### Launch ITKWidgets 1.0 using Jupyter Notebook Install ``` $ pip install 'itkwidgets[notebook]>=1.0a8' ``` and then use it in your notebook: ``` from itkwidgets import view ``` ### Launch ITKWidgets 1.0 using Jupyter Lab Install ``` $ pip install 'itkwidgets[lab]>=1.0a8' ``` and then use it in your notebook: ``` from itkwidgets import view ``` ### Launch ITKWidgets using Jupyter Lite ``` import piplite await piplite.install("itkwidgets==1.0a8") from itkwidgets import view ``` ### Launch itkwidgets using Google Colab Install and use it in your notebook: ``` import sys !{sys.executable} -m pip install -q "itkwidgets>=1.0a8" imageio from itkwidgets import view ``` Try the demo notebook [here](https://colab.research.google.com/github/InsightSoftwareConsortium/itkwidgets/blob/main/examples/Hello3DWorld.ipynb). ## Using the Web App By default, the web app loads the files `./test-data/HeadMRVolume.nrrd` and `./test-data/HeadMRVolumeLabels.nrrd`. To visualize a different image, mesh, or point set file in your local system you can set the `image` and `labelImage` arguments in `index.html` to the desired URL. Below, there are some examples to test the behavior of the UI by changing `index.html`: ![HeadMRVolume](HeadMRVolume-screenshot.png) ### Point Sets
Click to expand! ``` Custom itk-viewer Bootstrap UI Demo
```
### IPFS Image
Click to expand! ``` Custom itk-viewer Bootstrap UI Demo
```
### IPFS Image + Label
Click to expand! ``` Custom itk-viewer Bootstrap UI Demo
```
### 2D Image with multiple color channels You can introduce an extra argument to the `itkVtkViewer.createViewer` function to indicate your data set is bidimensional:
Click to expand! ``` Custom itk-viewer Bootstrap UI Demo
```
### 3D Image with multiple color channels
Click to expand! ``` Custom itk-viewer Bootstrap UI Demo
```