Skip to content

setup.md

Latest commit

 

History

History
52 lines (36 loc) · 1.53 KB

setup.md

File metadata and controls

52 lines (36 loc) · 1.53 KB
Raw

ConvertAsset Setup

Runtime Requirement

ConvertAsset relies on USD Python bindings from NVIDIA Isaac Sim. The pxr package is not treated as a normal pip dependency in this project; run CLI commands through Isaac Sim's Python environment.

Recommended entry:

./scripts/isaac_python.sh ./main.py <subcommand> [args]

The wrapper looks for Isaac Sim in this order:

  1. ISAAC_SIM_ROOT when it contains python.sh
  2. /isaac-sim/python.sh
  3. ~/.local/share/ov/pkg/isaac_sim-*
  4. /opt/nvidia/isaac-sim, /opt/NVIDIA/isaac-sim, /opt/omniverse/isaac-sim

Set an explicit root when auto-detection is not enough:

export ISAAC_SIM_ROOT=/abs/path/to/isaac-sim
./scripts/isaac_python.sh ./main.py no-mdl /abs/path/to/scene.usd

Python Package Imports

Keep heavy Isaac Sim imports lazy. Do not import pxr, omni.*, or other Isaac Sim-only modules at package import time. Import them inside functions or command handlers so lightweight tools and documentation checks can run without Isaac Sim.

Optional Native Mesh Backend

The Python QEM backend works without compiling native code. To enable the C++ backend, build native/meshqem and copy the generated meshqem_py extension into convert_asset/mesh/.

Detailed instructions:

Documentation Map