BuildingANARI

Instructions for how to build ANARI on Linux. This is the basic ANARI, independent of VR capabilities, which will be documented separately.

Building ANARI on Linux

The generic ANARI SDK has minimal system requirements to build. However, for the GPU-accelerated backends, there generally will be additional required features (such as Cuda or Optix).

When building ANARI, there is a choice between downloading/cloning the reference ANARI-SDK, and separately obtaining the GPU accelerated backends, or it is possible to download the pseudo-Superbuild that will download selected backends, and do a complete build.

This documentation last tested with ANARI-SDK version 0.10.1.

Prerequisites

ANARI makes use of the CMake build system. You should have at least version 3.11 of CMake.

Cloning ANARI

Clone from the Khronos Github ANARI reposoitory.

NOTE: Because ANARI is still in flux, I always add the current date (YYYYMMDD) and Version as a postfix of my cloned directory name.

% git clone -b next_release --single-branch https://github.com/KhronosGroup/ANARI-SDK.git anari-sdk-<date>nr

or for the master branch:

% git clone https://github.com/KhronosGroup/ANARI-SDK.git

Configuring the Build and Installing

Configuring and compiling the build:

% mkdir ANARI-SDK/Build
% cd ANARI-SDK/Build
% cmake -DCMAKE_INSTALL_PREFIX=... -DCMAKE_BUILD_TYPE:STRING=Release -DBUILD_CTS:BOOL=OFF -DBUILD_TESTING:BOOL=OFF -DBUILD_REMOTE_DEVICE:BOOL=ON -DINSTALL_VIEWER:BOOL=ON ..
% make
% make install

Running ANARI

The ANARI build process includes a simple tutorial application that will render a scene consisting of a pair of triangles into two image files (one with the first pass of the render, and one with a later pass). An optional "anariViewer" may also be built (and the above instructions will build it) which contains a handful of reference scenes, along with an OBJ viewer.

Running the ANARI backend info tool

% ./anariInfo -l helide

This will then output a slew of information about the backend, including what version of ANARI it was built for, and what Parameters and Extensions it handles. In some respect, it can be considered a quick summary of the ANARI specification, insofar as how that particular library implements the spec.

Running the ANARI tutorial example

Note that the "anariTutorial" executable (without code changes) will always use the helide backend.

% ./anariTutorial
% display *.ppm

Running the ANARI viewer example

The choice of ANARI backend for anarViewer is controlled by the ANARI_LIBRARY environment variable

% export ANARI_LIBRARY=helide
% ./anariViewer

Build/Install additional ANARI backends

Once the base ANARI SDK is built, additional backends can be compiled and added to the overall ANARI installation.

VisRTX & VisGL ANARI backends (building/installing)

% module load optix cuda anari
% git clone -b next_release --single-branch https://github.com/NVIDIA/VisRTX visrtx2_version
% mkdir visrtx2_version/Build
% cd visrtx2_version/Build
% cmake -DCMAKE_INSTALL_PREFIX=$ANARI_DIR(<same-as-ANARI-base>)  ..
% make
% make install

Then:

% export ANARI_LIBRARY=visrtx
% anariViewer

Other backends

• OSPRay
• Barney ANARI backend (BANARI)
• Visionaray ANARI backend

Suggestions for improving ANARI

I have a few things that I need to pass along to the ANARI working group that could/should be fixed in future versions -- especially by the time we get to SDK version 1.0.0.

• anariTutorial should honor the ANARI_LIBRARY flag.
• Running anariInfo -l visgl shouldn't seg-fault
• Running anariInfo -l <non-existant backend> shouldn't seg-fault

Other issues that I am personally experiencing

• My ANARI-VR test programs render incorrectly when running with the visgl backend
• My ANARI-VR test program (anari_ex8) crashes when running with the any backend
• When running anariInfo -l visrtx there appear to be some spaces in parameter names that are bugs — e.g. " transform" & " transferFunction1D"
  • Probably anariInfo should put quotes around subtype and parameter names to make these errors more obvious
• There is some code in the installed share/anari directory that I'm not sure what it does/is-for

ANARI Applications

Here are some other applications that are using ANARI:

• VTK
  • vtkAnariPass Class
  • Amstutz' VTK ANARI examples (C++ & Trame)
• ParaView
  • Building ParaView with ANARI support (Discourse conversation)
  • Dynamic GUI for ANARI devices (Discourse conversation)
• ANARI Volume Viewer (on Github.com)
• VTK-m Graph tool
  • Uses: VTK-m