README.md

Volume rendering using ClaraViz

This application loads a medical CT scan and renders it in real time at interactive frame rates using ClaraViz (https://github.com/NVIDIA/clara-viz).

The application uses the VolumeLoaderOp operator to load the medical volume data, the VolumeRendererOp operator to render the volume and the HolovizOp operator to display the result and handle the camera movement.

Data

You can find CT scan datasets for use with this application from embodi3d.

Datasets are bundled with a default ClaraViz JSON configuration file for volume rendering. See VolumeRendererOp documentation for details on configuration schema.

See VolumeLoaderOp documentation for supported volume formats.

Build and Run Instructions

To build and run this application, use the dev_container script:

# C++
 ./dev_container build_and_run volume_rendering --language cpp

 # Python
  ./dev_container build_and_run volume_rendering --language python

The path of the volume configuration file, volume density file and volume mask file can be passed to the application.

You can use the following command to get more information on command line parameters for this application:

./dev_container build_and_run volume_rendering --language [cpp|python] --run_args --usages

Dev Container

To start the the Dev Container, run the following command from the root directory of Holohub:

./dev_container vscode

VS Code Launch Profiles

C++

Use the (gdb) volume_rendering/cpp launch profile to run and debug the C++ application.

Python

There are a couple of launch profiles configured for this application:

1. (debugpy) python_rendering/python: Launch the Volume Rendering application with the ability to debug Python code.
2. (pythoncpp) python_rendering/python: Launch the Volume Rendering application with the ability to debug both Python and C++ code.