Package: clara-viz-widgets
Quick StartInstallationThis will install all Clara Viz packages use pip:$pipinstallclara-vizClara Viz is using namespace packages. The main functionality is implemented in the 'clara-viz-core' package,
Jupyter Notebook widgets are found in the 'clara-viz-widgets' package.
So for example if you just need the renderer use$pipinstallclara-viz-coreUse interactive widget in Jupyter NotebookInstall the Jupyter notebook widgets.$pipinstallclara-viz-widgetsStart Jupyter Lab, open the notebooks in thenotebooksfolder. Make sure Git LFS is installed when cloning the repo, else the data files are not downloaded correctly and you will see file open errors when using the example notebooks.fromclara.viz.widgetsimportWidgetfromclara.viz.coreimportRendererimportnumpyasnp# load a RAW CT data file (volume is 512x256x256 voxels)input=np.fromfile("CT.raw",dtype=np.int16)input=input.reshape((512,256,256))display(Widget(Renderer(input)))Render CT data from PythonfromPILimportImageimportclara.viz.coreimportnumpyasnp# load a RAW CT data file (volume is 512x256x256 voxels)input=np.fromfile("CT.raw",dtype=np.int16)input=input.reshape((512,256,256))# create the rendererrenderer=clara.viz.core.Renderer(input)# render to a raw numpy arrayoutput=renderer.render_image(1024,768,image_type=clara.viz.core.ColorImageType.RAW_RGBA_U8)rgb_data=np.asarray(output)[:,:,:3]# show with PILimage=Image.fromarray(rgb_data)image.show()clara-viz 0.3.1 (July 12 2023)Bug FixesGracefully disable OptiX denoiser if it can't be createdmake nvjpeg support optionalclara-viz 0.3.0 (June 22 2023)FeaturesC++ interface is now publicAdd support for aarch64 (not for Python wheels)Add support for VR/AR renderingCamera has stereo mode and left end right eye poses, tangents and gaze directionsAdd warped and foveated renderingAdd reprojectionAdd support for separate depth bufferAdd support for alpha channelAdd support for near and far depth planeAdd support for transforming the volume using a matrixBug FixesFix tonemap enable, had no effect before (always enabled).AttributeError: module 'itk' has no attribute 'itkSpatialOrientationPython' (https://github.com/NVIDIA/clara-viz/issues/26)SecurityUpdate Jupyter widget Java code packages to fix vulnerability CVE-2022-46175clara-viz 0.2.2 (October 17 2022)Bug FixesJupyter notebooks fail with AttributeError: 'Widget' object has no attribute 'on_displayed' (https://github.com/NVIDIA/clara-viz/issues/23)SecurityUpdate Jupyter widget Java code packages to fix vulnerabilitiesDocumentationpip install fails on Windows machines (https://github.com/NVIDIA/clara-viz/issues/22)Windows is not supported, added a section on supported OS to readmeclara-viz 0.2.1 (March 29 2022)Bug FixesWidget can't be displayed because of version mismatchclara-viz 0.2.0 (March 29 2022)FeaturesAdd support for rendering multi resolution images used in digital pathologySecurityUpdate Jupyter widget Java code packages to fix vulnerabilitiesBug FixesError when using a widget with a renderer using a numpy array (https://github.com/NVIDIA/clara-viz/issues/18)DocumentationFix typo forimage_typeparameter in the sample code of the readme fileExtended documentation, added multi resolution image renderingclara-viz 0.1.4 (Feb 15 2022)SecurityUpdate Jupyter widget Java code packages to fix vulnerabilitiesBug FixesRegression - cinematic rendering example throws an error (https://github.com/NVIDIA/clara-viz/issues/16)clara-viz 0.1.3 (Jan 31 2022)NewSupport installation of recommended dependenciesBug FixesFailed to load data files with ITK when using Clara Train docker image (https://github.com/NVIDIA/clara-viz/issues/12)Rendering is wrong when passing non-contiguous data in (e.g. transposed numpy array)Widget interaction in slice mode not working correctly (https://github.com/NVIDIA/clara-viz/issues/13)clara-viz 0.1.2 (Jan 19 2022)Bug FixesWhen the renderer is immediately destroyed after creation there is a segmentation fault. This could happen when providing a unsupported data type (e.g. 64 bit floating point values), when creating a temporary object (e.g. in Pythonprint(Renderer(data)))) or when the initialization of the Renderer failed. (https://github.com/NVIDIA/clara-viz/issues/7,https://github.com/NVIDIA/clara-viz/issues/8)Widget is not working with Jupyter Notebooks (but with Jupyter Lab) (https://github.com/NVIDIA/clara-viz/issues/9)DocumentationAdded missingvideocapability to docker run commandclara-viz 0.1.1 (Dec 14 2021)Bug FixesWhen installing theclara-viz-corePython package only there is the errorModuleNotFoundError: No module named 'packaging'when doingimport clara.viz.coreWhen getting the settings from the renderer the 'TransferFunctions' sections is returned as 'Transferfunctions' with lower case 'f'DocumentationAdded a section on using Clara Viz within a docker container.Added a link to the documentation.Added a section on WSL (Windows Subsystem for Linux).NotebooksThe DataDefinition class is using ITK to load the data files, make sure ITK is available.Added a slice rendering example (Slice_rendering.ipynb)Fixed the check if the volume file exists in Render_image.ipynb, also fixed volume orientation and scaling.Updated the settings files to match the settings conventions used by the renderer.MiscChanged the camera names and removed theSliceprefix of the orthographic cameras. Renamed the perspective camera fromCinematictoPerspectiveclara-viz 0.1.0 (Dec 3 2021)Initial release of Clara Viz