Skip to main content
`Ctrl`+`K`

# ovphysx

ovphysx is a self-contained library package offering the PhysX SDK and Omni PhysX capabilities behind a C API and corresponding Python bindings for inclusion in user applications. It loads USD scenes, runs simulation, and allows reading and writing simulation data with DLPack interoperability.

Note

Pre-release notice: ovphysx is pre-release software and not yet mature. Current limitations include a strict in-process USD requirement: ovphysx can only coexist with OpenUSD v25.11 that is non-monolithic, Python-enabled, and linked against oneTBB (in particular, ovphysx cannot be used together with `usd-core` in the same process today), and parts of the API are still being completed and may change before 1.0.

It packages the Omni PhysX runtime (providing in particular USD-aware simulation and tensorized data access) on top of the PhysX SDK. The dependency stack is: PhysX SDK → omni.physx (Omniverse integration) → ovphysx (standalone C/Python SDK).

The source repository of ovphysx can be found at NVIDIA-Omniverse/PhysX.

External references:

- Omni PhysX User Guide

- PhysX SDK Documentation

These documentation pages contain the following:

Overview

- ovphysx Overview
  - Relationship to PhysX SDK and Omni PhysX
  - Who This Is For
  - What You Can Do
  - Core Concepts
  - End-to-End Usage in Python
  - C/C++ SDK
  - Release and distribution
  - Versioning and compatibility
  - Runtime Warnings
  - PhysX SDK and Omni PhysX Documentation
  - Conclusion
- Developer Guide
  - Relationship and Consumption Model
  - Samples and Tutorials
  - Execution Model
  - Multi-Instance Support
  - Operation Indices and Polling
  - Threading
  - Ownership and Lifetimes
  - Dependency Management
  - Error Handling
  - GPU Warmup and Determinism
  - Scene Cloning
  - Logging

Tutorials

- SDK Quickstart
- Hello World: Load USD and Step
- Tensor Bindings: Read and Write Simulation Data
- Cloning: Replicate Environments
- Rendering Handoff

API Reference

- Python API Reference
- C API Reference

Legal

- Security