Selecting Backends
When To Use
Use this skill when a user needs to choose, configure, compare, or debug Isaac Lab physical backends or renderer-related behavior.
Do not use this skill to duplicate backend reference material. Link to the backend architecture, backend and preset selector, schema cfg docs, and source examples for current configuration details. If the user is converting or validating a specific USD asset for Newton, use isaaclab-preparing-assets-for-newton.
Workflow
- Identify the target backend: PhysX, Newton, OvPhysX, or a task that must
support multiple backends through presets.
- Read the physics-backends concept, backend architecture, backend and preset
selector, and schema cfg docs before editing backend configs.
- Start with the backend that best matches the source task or current maintained example. Use PhysX first when matching Isaac Gym behavior.
- Add backend presets only after the task runs on one backend.
- Map simulation parameters through public cfg schemas instead of copying old simulator-specific keys. Import universal schema fragments and base cfgs from
isaaclab.sim.schemas, PhysX-specific cfgs from isaaclab_physx.sim.schemas, and Newton or MuJoCo cfgs from isaaclab_newton.sim.schemas.
- Check backend support for sensors, randomization events, terrain, contacts, and actuators before enabling them.
- Separate backend-specific differences using
PresetCfg or existing preset helpers rather than runtime conditionals scattered through task code.
- Use suffixless task names in backend smoke-test and training commands.
- Validate each backend with a small reset/step rollout before training.
- For backend architecture changes, resolve shared native runtimes through
SimulationContext.get_or_create_backend(...) instead of copying state between consumers.
- Document intentional behavior differences, especially around contacts, randomization timing, CPU/GPU data paths, and renderer requirements.
Validation
Use this checklist:
- Run a small reset/step smoke test on the primary backend.
- Run the same smoke test on each selected backend before training.
- Compare observation shape, action shape, reset behavior, and contact behavior.
- Check randomization events for backend-specific support and device assumptions.
- Run short training only after each selected backend passes its smoke test.
For skill changes, run:
uv run --no-project python tools/skills/cli.py check
Maintenance
Keep this skill synchronized with docs/source/concepts/physics_backends.rst, docs/source/concepts/backends_and_presets.rst, docs/source/concepts/schema_cfgs.rst, and backend-aware task examples under source/isaaclab_tasks/isaaclab_tasks/. If backend docs are incomplete, improve the docs rather than expanding this skill into a backend reference.
References
1---2name: isaaclab-selecting-backends3description: Selects and validates Isaac Lab physics and rendering backends. Use when choosing PhysX, Newton, or OvPhysX, adding backend presets, comparing backend behavior, or debugging backend-specific simulation, randomization, sensor, or renderer issues.4audience: user5status: experimental6owners:7 - isaaclab-maintainers8metadata:9 source: https://skillmd.com/skills/isaac-sim/isaaclab-selecting-backends10---1112# Selecting Backends1314## When To Use1516Use this skill when a user needs to choose, configure, compare, or debug Isaac Lab physical backends or renderer-related behavior.1718Do not use this skill to duplicate backend reference material. Link to the backend architecture, backend and preset selector, schema cfg docs, and source examples for current configuration details. If the user is converting or validating a specific USD asset for Newton, use `isaaclab-preparing-assets-for-newton`.1920## Workflow21221. Identify the target backend: PhysX, Newton, OvPhysX, or a task that must23 support multiple backends through presets.242. Read the physics-backends concept, backend architecture, backend and preset25 selector, and schema cfg docs before editing backend configs.263. Start with the backend that best matches the source task or current maintained example. Use PhysX first when matching Isaac Gym behavior.274. Add backend presets only after the task runs on one backend.285. Map simulation parameters through public cfg schemas instead of copying old simulator-specific keys. Import universal schema fragments and base cfgs from `isaaclab.sim.schemas`, PhysX-specific cfgs from `isaaclab_physx.sim.schemas`, and Newton or MuJoCo cfgs from `isaaclab_newton.sim.schemas`.296. Check backend support for sensors, randomization events, terrain, contacts, and actuators before enabling them.307. Separate backend-specific differences using `PresetCfg` or existing preset helpers rather than runtime conditionals scattered through task code.318. Use suffixless task names in backend smoke-test and training commands.329. Validate each backend with a small reset/step rollout before training.3310. For backend architecture changes, resolve shared native runtimes through34 `SimulationContext.get_or_create_backend(...)` instead of copying state between consumers.3511. Document intentional behavior differences, especially around contacts, randomization timing, CPU/GPU data paths, and renderer requirements.3637## Validation3839Use this checklist:40411. Run a small reset/step smoke test on the primary backend.422. Run the same smoke test on each selected backend before training.433. Compare observation shape, action shape, reset behavior, and contact behavior.444. Check randomization events for backend-specific support and device assumptions.455. Run short training only after each selected backend passes its smoke test.4647For skill changes, run:4849```bash50uv run --no-project python tools/skills/cli.py check51```5253## Maintenance5455Keep this skill synchronized with `docs/source/concepts/physics_backends.rst`, `docs/source/concepts/backends_and_presets.rst`, `docs/source/concepts/schema_cfgs.rst`, and backend-aware task examples under `source/isaaclab_tasks/isaaclab_tasks/`. If backend docs are incomplete, improve the docs rather than expanding this skill into a backend reference.5657## References5859- [Evaluations](evaluations.md)60- [Examples](examples.md)61- [Prepare assets for Newton skill](../prepare-assets-for-newton/SKILL.md)62- [Physics backends](../../../docs/source/concepts/physics_backends.rst)63- [Backends and presets](../../../docs/source/concepts/backends_and_presets.rst)64- [Renderers, including asynchronous rendering](../../../docs/source/concepts/renderers.rst)65- [Schema cfgs](../../../docs/source/concepts/schema_cfgs.rst)66- [Installation](../../../docs/source/isaaclab/installation.rst)67- [Task examples](../../../source/isaaclab_tasks/isaaclab_tasks)