Skip to main content
Ctrl+K
ovphysx SDK - Home ovphysx SDK - Home

ovphysx SDK

  • github
  • twitter
  • youtube
  • instagram
  • www
  • linkedin
  • twitch
ovphysx SDK - Home ovphysx SDK - Home

ovphysx SDK

  • github
  • twitter
  • youtube
  • instagram
  • www
  • linkedin
  • twitch

Table of Contents

Overview

  • ovphysx Overview
  • Developer Guide
  • OV Libraries V2 Transitional Annex: Timeout Type
  • Local Development
  • Changelog

ovstage Integration

  • ovstage Integration and Physics Output Read

Simulation Setup

  • Physics Scene and Simulation Configuration
  • Colliders
  • Rigid Bodies
  • Kinematic Support Geometry
  • Joints
  • Articulations
  • Deformable Bodies
  • Particles

Physics Schemas

  • Physics Schemas
  • ovstage Physics Population Domain
    • Capsule
    • Cone
    • Cube
    • Cylinder
    • Material
    • Mesh
    • PhysicsCollisionGroup
    • PhysicsDistanceJoint
    • PhysicsFixedJoint
    • PhysicsJoint
    • PhysicsPrismaticJoint
    • PhysicsRevoluteJoint
    • PhysicsScene
    • PhysicsSphericalJoint
    • PhysxPhysicsGearJoint
    • PhysxPhysicsRackAndPinionJoint
    • Plane
    • Sphere
    • Xform
    • MaterialBindingAPI (physics purpose)
    • PhysicsArticulationRootAPI
    • PhysicsCollisionAPI
    • PhysicsDriveAPI
    • PhysicsFilteredPairsAPI
    • PhysicsJointStateAPI
    • PhysicsLimitAPI
    • PhysicsMassAPI
    • PhysicsMaterialAPI
    • PhysicsMeshCollisionAPI
    • PhysicsRigidBodyAPI
    • PhysxArticulationAPI
    • PhysxCollisionAPI
    • PhysxContactReportAPI
    • PhysxConvexDecompositionCollisionAPI
    • PhysxConvexHullCollisionAPI
    • PhysxDrivePerformanceEnvelopeAPI
    • PhysxJointAPI
    • PhysxJointAxisAPI
    • PhysxLimitAPI
    • PhysxMaterialAPI
    • PhysxPhysicsDistanceJointAPI
    • PhysxRigidBodyAPI
    • PhysxSDFMeshCollisionAPI
    • PhysxSceneAPI
    • PhysxSphereFillCollisionAPI
    • PhysxSplinesSurfaceVelocityAPI
    • PhysxSurfaceVelocityAPI
    • PhysxTriangleMeshCollisionAPI
    • PhysxTriangleMeshSimplificationCollisionAPI
    • PhysxTriggerAPI
    • Prim identity and transform
    • Stage units
    • Fixed-base two-link articulation
    • Floating-base two-link articulation
    • Kinematic conveyor Cube with a surface velocity
    • Two rigid-body Cubes on a D6 joint
    • Two rigid-body Cubes on a distance joint
    • Two rigid-body Cubes on a fixed joint
    • Two hinged rigid-body Cubes coupled by a gear joint
    • Rigid-body Cube bound to a physics Material
    • Physics scene
    • Two rigid-body Cubes on a prismatic joint
    • A hinged pinion Cube and a sliding rack Cube coupled by a rack-and-pinion joint
    • Two rigid-body Cubes on a revolute joint
    • Dynamic rigid body on a Capsule
    • Dynamic rigid body on a Cone
    • Dynamic rigid body on a Cube
    • Two dynamic rigid-body Cubes
    • Dynamic rigid body on a Cylinder
    • Dynamic rigid body on a Sphere
    • Two rigid-body Cubes on a spherical joint
    • Static Plane collider
    • Recorded findings

Read/Write Data Contract

  • Overview
  • Data model and semantics
  • Device residency and interop
  • Readable data
  • Writable data
  • Known limitations and gaps

Tutorials

  • Quickstart
  • Hello World – Populate ovstage and Step
  • Tensor Bindings (deprecated)
  • Contact Binding – Reading Contact Forces
  • Cloning – Replicate Environments
  • Rendering Handoff
  • PhysX Interop – Direct PhysX SDK Access
  • OmniPVD Recording – Capture Physics Internals to FILE or TCP
  • NVTX Profiling in Nsight Systems
  • Building Against the ovphysx Source Tree

Guides

  • Simulation Performance Guide
  • Collision Behavior Guide
  • Articulation and Robot Simulation Stability Guide
  • Joint Parameter Tuning Example: Robotiq 2F-85
  • Known Physics Limitations

API Reference

  • Python API Reference
  • C API Reference

Legal

  • Security
  • ovstage Physics Population Domain
  • Fixed-base two-link articulation

Fixed-base two-link articulation#

Multi-prim test composition: a two-link reduced-coordinate articulation. /World/Base and /World/Link are Cube rigid bodies one unit apart joined by /World/Hinge, a PhysicsRevoluteJoint with body0 the parent (Base) so no sign flip applies to drive and state. /World/RootJoint is a PhysicsFixedJoint with only body1 (Base) authored, so body0 is the world; it carries PhysicsArticulationRootAPI and PhysxArticulationAPI and, being a joint to world, is elected root: the runtime sets PxArticulationFlag::eFIX_BASE and creates no PxJoint for it. The articulation is observed on the root-API prim. The hinge is verified through the articulation joint (PhysxJointAPI, PhysxJointAxisAPI, PhysicsJointStateAPI, PhysxDrivePerformanceEnvelopeAPI columns); its standalone PxJoint columns are unobservable here (NaN on both sides). Owns no columns and generates no helper.

  • Form: multi-prim; no helper, the contract test builds each prim with PrimBatch.

Path

Type

Applied APIs

Authored values

Relationships

Verified

/World/Base

Cube

PhysicsRigidBodyAPI, PhysicsCollisionAPI

size

no

/World/Link

Cube

PhysicsRigidBodyAPI, PhysicsCollisionAPI

size, omni:xform

no

/World/RootJoint

PhysicsFixedJoint

PhysicsArticulationRootAPI, PhysxArticulationAPI

physics:body1 -> /World/Base

yes

/World/Hinge

PhysicsRevoluteJoint

PhysxJointAPI, PhysicsDriveAPI:angular, PhysxJointAxisAPI:angular, PhysicsJointStateAPI:angular, PhysxDrivePerformanceEnvelopeAPI:angular

physics:localPos0, physics:localPos1

physics:body0 -> /World/Base, physics:body1 -> /World/Link

yes

previous

Stage units

next

Floating-base two-link articulation

NVIDIA NVIDIA

Copyright © 2025-2026, NVIDIA Corporation.

Last updated on Sep 11, 2026.