Quick tour
A five-minute walkthrough of the viewer after you sign in.
1Check your connection
Click Infrastructure in the top right. The panel that opens is titled Choose infra.
- Cloud — a hosted preview on Examples. Your own files, filters, and Python run on on-prem today. Hosted cloud with those tools follows feedback from that use. 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 tree
Open the Scene card on the left.
- The top row is the Source — the file or example you loaded.
- Clip, Warp, Extract cells, and Extract points appear underneath when you create them.
- Click a row to show that result. Use the eye icon to show or hide a layer.
- Double-click the source to fit the model in the view.
The path at the bottom right shows which row is selected.
4Adjust rendering
Open the Rendering card.
- Pick a display style — points, wireframe, surface, or surface with edges.
- Choose a Scalar Field, or Solid color for a single color.
- With a scalar active, pick a Colormap and set Opacity.
- 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.
5Apply a filter
Cloud preview: skip to step 6 and keep exploring the example. Filters are part of the full tool set on on-prem. See Cloud connection for why hosted cloud waits.
Open Filters and choose a type:
- 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 on X, Y, or Z.
- Stage visibility — show or hide the mesh without creating a new result. Cameras, lights, and guides are not in this control yet.
Edit the settings in Filter properties. The server rebuilds the surface. Wait until the view updates before you judge the result.
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 (Viewport → Display → Axis) snaps to an axis-aligned view. Align model, along the top, fits the model, rolls the camera, and switches display style. VTK dataset info (ℹ️) summarizes the selected scene-tree row when that tool is available. See Viewport controls.
7Time
If the dataset has more than one time step, open Time controls along the top: step, scrub, play, and pause.
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
- Load simulation data — formats and what to expect while a file converts
- Filters — warp, clip, and the wait while the server rebuilds
- Time animation — playback and preparing frames
- Viewport controls — every control along the top and in the sidebar
- Why Three.js? — why the view is drawn this way