Quick tour

A short first session in the viewer after you sign in. Panel and toolbar names: Viewer layout.

Scenaven
Scenaven

1Check your connection

Click Infrastructure in the top right. The panel that opens is titled Choose infra.

  • Cloud — hosted Examples to learn the viewer. Your own files, filters, and Python use on-prem today. See Cloud connection.
  • On-prem — in Choose infra, follow the Docker setup the panel shows. After Docker is running, switch to On-prem in that same panel. You stay in this viewer. See On-prem connection.
  • Status should read Connected before you load anything.

If it says Not connected, stay in Infrastructure. For on-prem, open Self-hosted setup and follow the Docker steps in that panel. Switch to On-prem after Docker is running. See On-prem connection.

2Load data

On a cloud preview: click Examples and pick a dataset. See Examples gallery.

When you can upload: click Open and choose a VTK file. The server converts it. You do not open a USD file yourself.

Open adds to the scene you already have. Choose New scene in that same menu when you want to start over. A progress card may appear at the bottom of the sidebar while conversion runs.

3Explore the Scene card

Open the Scene card on the left. It lists the OpenUSD stage hierarchy—not just a flat “Source” line.

  • Each dataset you loaded appears as a named source row with nested geometry (and parts, if the model is split).
  • Clip, Warp, and Extract rows appear when you compile those filters; they sit in the same tree as the stage the server wrote.
  • Click a row, or click mesh in the view (the cursor shows a pointer over selectable geometry), to activate it. Use the eye to show or hide a layer.
  • Use the chevron on a row to expand or collapse a branch; the small expand/collapse control in the card header affects all branches at once.
  • Double-click a source row to fit that model in the view.

The path at the bottom right shows which prim or row is selected.

See Scene tree for Geometry / Materials folders, material and geometry shortcuts, visibility, and remove.

4Color and draw the mesh (Scene → Selected prim)

Stay in the Scene card. Select a mesh row in the stage tree so Selected prim shows the inspector for that geometry.

  1. Pick a display style — points, wireframe, surface, or surface with edges (representation may also be duplicated on the top Display menu).
  2. Choose a Scalar Field, or Solid color for a single color.
  3. With a scalar active, pick a Colormap and set Opacity.
  4. Use the color swatches for the solid color and for edges when those styles are on.

The legend at the bottom of the view shows the range of the active field.

5Clip, warp, or extract (same Scene card)

Cloud preview: skip to step 6 and keep exploring the example. Server-side clip, warp, and extract on your own files are part of the full tool set on on-prem. See Cloud connection for why hosted cloud waits.

With a VTK mesh row selected, use the shortcuts in the Selected prim header (same Scene card):

  • Warp — move the mesh by a vector or scalar field, to show displacement or exaggerate a shape.
  • Planar clip — cut the model with a plane; adjust settings in the panel below Selected prim.
  • Extract cells or Extract points — draw a region in the view, then the server keeps what lies inside (see Stage operations).
  • Use the eye on scene-tree rows for visibility only — that does not create a new result prim.

The OpenUSD stage tree updates when a compile finishes: new Clip, Warp, or Extract rows appear under Geometry. Wait until the tree and view refresh before you change settings again.

For a clip, turn on Show clip plane in viewport and drag the plane in the 3D view.

6Viewport and camera

Open the Viewport card to change:

  • Theme (dark or light) and Background
  • Grid and Bounds
  • Lighting and Exposure
  • Camera projection, field of view, and Zoom to cursor

The Axis control at the bottom left of the Viewport card snaps to an axis-aligned view. The viewport also exposes camera moves, display representation (how the surface is drawn), and—when the dataset is transient—time stepping. VTK dataset info (ℹ️) summarizes the selected scene-tree row when that tool is available.

7Time

If the dataset has more than one time step, time controls appear with the viewport: step, scrub, play, and pause. See Time animation.

With Warp or Clip in the scene tree, the first Play may show Building animation… while the server prepares every frame. That wait is separate from the message you see when you change a filter on the current frame. See Time animation.

8amAIra and Python

Cloud preview: amAIra skills that run on the simulation, and the Python session, are part of the full tool set on on-prem. See Cloud connection.

After you sign in on the home page, the right edge can show two tabs:

  • amAIra — ask about the scene you are looking at
  • Python session — run a short snippet on that same simulation

Both need a signed-in session and Infrastructure on Connected. See Antinode for the account, and Agentic workflows for Knowledge, Skills, and slash commands.

Next steps