Python: Status Queries Example#

This example is based on the minimal Python example and adds operation status queries for the async operations in that flow.

It demonstrates:

  1. Creating a Renderer with an attached ovstage Stage

  2. Loading a remote S3 scene with ovstage.population.open_usd_async(), polling with bounded waits (population operations expose no status counters)

  3. Running one shader-cache warm-up step with shader compilation progress

  4. Stepping the renderer with step_async() and querying status while waiting

  5. Fetching and mapping the rendered output

Renderer logs are written to _output/status-queries-ovrtx.log.

“Create a Python rendering example that demonstrates progress reporting for long-running ovrtx operations, including asynchronous scene loading, status polling while waiting, shader warmup feedback, final frame rendering, and save-or-display output.”

Status queries example output

Prerequisites#

  • Python 3.10-3.13

  • uv

  • NVIDIA RTX-capable GPU

  • Supported NVIDIA driver

  • Internet access to download the remote S3 scene asset

  • Unsandboxed runtime execution

Running#

uv run main.py

To save the render instead of displaying it:

uv run main.py --png
On this page