Load simulation data

Supported formats

If Open rejects a file, check the extension. The viewer accepts the formats listed above.

Step-by-step: open a file

1. Click Open in the top-right HUD.
2. Select a file from your computer.
3. Wait for conversion (volumetric files only):

- Progress appears in the sidebar footer as Cloud conversion or Local conversion.

- Percentage and status messages update until complete.

1. The mesh appears in the viewport.
2. The Scene card shows a Source row (labeled with your filename when available).
3. Scalar fields populate the Rendering card after metadata loads.

Step-by-step: open an example

1. Confirm Infrastructure shows Connected.
2. Click Examples in the top-right HUD.
3. Choose a card from the gallery.
4. The example activates on mesh-api without re-uploading.

See Examples gallery for cloud vs on-prem behavior.

Connection requirements

Upload and conversion require a healthy mesh-api connection:

• Open Infrastructure — status should be Connected.
• Cloud mode needs a valid signed-in session.
• On-prem mode needs the Docker stack running and the correct mesh-api URL configured.

If upload fails, check the sidebar toast or browser console for HTTP errors (network, auth, or server busy).

Performance tips

• Large VTKHDF files — Conversion runs entirely on mesh-api. The viewport stays interactive; avoid closing the tab during upload.
• Try Examples first — Useful for learning the UI without waiting on a big upload.
• Same host for on-prem — If Docker runs on a LAN machine, open the viewer using that machine's hostname (not only localhost) when accessing from another device on the network.

After load

Troubleshooting