Prepare Assets For Newton With MJWarp
When To Use
Read the asset migration guide first. This skill follows that page in the same order and targets Newton with MJWarp, not Newton solvers generally. Use the sim-to-sim skill only after the asset and task run in both backends.
1D cable / rod assets are out of scope here: they are authored fresh as Newton deformables (Newton + VBD only), not converted from a PhysX rigid asset. See the Deformables guide.
Implicit MPM particle assets and rigid-MPM coupling are also out of scope; see the Implicit MPM page.
Workflow
- Multi-backend Asset Importing Pipeline. Use provided Isaac Lab assets directly in PhysX and MJWarp; Newton parses their supported authored USD Physics and PhysX properties. For a new URDF or MJCF, keep
run_asset_transformer=True and run_multi_physics_conversion=True so the importer creates neutral, PhysX, and MuJoCo payloads. Account for its nested rigid-body structure.
- Use per-solver schema fragments. Pass a list of fragments to each spawner field. Put common USD Physics properties in solver-common fragments such as
UsdPhysicsRigidBodyCfg. Put MJWarp-specific fields in Mujoco*Cfg, Newton-native fields in Newton*Cfg, and PhysX-only fields in Physx*Cfg. Confirm support in the generated schema APIs.
- Audit the authored mechanical model. Check every dynamic link and contact-relevant object for intentional mass, COM, inertia and frames, collision geometry, approximation and scale, materials, articulation root, fixed-base and fixed-joint representation, joint axes and limits, self-collision, and gravity overrides.
- Match contact and friction behavior. Expect more default slip in MJWarp. Validate colliders, material bindings, contact locations and gripper force. Set per-shape
condim with MujocoCollisionCfg, tune material friction, then set global MJWarpSolverCfg(cone=..., impratio=...). Treat priority, solmix, solref, and solimp as expert per-collider overrides. Use fixed-grasp displacement, contact count, effort, penetration, and success metrics.
- Velocity limits distinction.
actuator_velocity_limit is a rated speed and joint_velocity_limit is a requested solver clamp. Isaac Lab writes the latter to Newton's model, but MJWarp does not consume or enforce it; Kamino does. Add task or control checks for required speed bounds under MJWarp. Use joint_effort_limit for solver limits and actuator_effort_limit to clip explicit actuator models.
- Why MJWarp often needs more armature. Use reflected rotor inertia or controlled response tests for articulated coordinates. A plain rigid object has body inertia, not actuator armature. Correct mass, inertia, units, reset penetration, effort, action scale, control period, and contact capacity before changing armature.
- Retune damping with armature. Increasing armature changes effective inertia and damping ratio. Tune armature, stiffness, and damping together from a step response, use conservative action scales, and keep targets away from hard stops to prevent bang-bang control.
- Choose an MJWarp starting profile. Do not translate PhysX parameters numerically. Start from the nearest profile on the MJWarp solver page, keep the documented convergence defaults initially, enable
NewtonCfg.debug_mode, and use MuJoCo contacts unless the task requires NewtonCfg.collision_cfg. Then run zero and random agents in PhysX and MJWarp through multiple resets. Check non-finite state, first-step impulses, saturation, excessive angular velocity, contact loss, and warnings. Reject penetrations, impossible mimic states, and invalid randomized geometry before stepping.
- Diagnose MJWarp-only failures. Reproduce the first bad step with one environment, a fixed state, no randomization, and identical actions. Classify initialization/model, contact/capacity, control, or dense-scene failures before tuning. Raise overflowing capacity first; change convergence settings only after the asset, reset, controller, contact model, and capacities are valid.
Validation
Require an asset that parses into both backends with supported per-solver fields, intentional mass, collision and contact data, physically justified actuator parameters, finite task behavior, and valid resets. Do not classify an asset as ready while importer or solver warnings remain unexplained.
Maintenance
Keep this skill synchronized section-for-section with the asset migration guide and use the MJWarp solver page for current profile values.
References
1---2name: isaaclab-preparing-assets-for-newton3description: Migrates PhysX-compatible robot, object, and scene assets to Isaac Lab's Newton backend with MJWarp. Use when handling existing Isaac Lab assets or new multi-physics conversion, per-solver asset configuration, mass or inertia warnings, contact slip and friction, velocity-limit behavior, armature and damping, MJWarp solver profiles, solver-specific failures, or task-level validation.4audience: user5status: experimental6owners:7 - isaaclab-maintainers8metadata:9 source: https://skillmd.com/skills/isaac-sim/isaaclab-preparing-assets-for-newton10---1112# Prepare Assets For Newton With MJWarp1314## When To Use1516Read the [asset migration guide](../../../docs/source/how-to/prepare_asset_for_newton.rst) first. This skill follows that page in the same order and targets Newton with MJWarp, not Newton solvers generally. Use the sim-to-sim skill only after the asset and task run in both backends.17181D cable / rod assets are out of scope here: they are authored fresh as Newton deformables (Newton + VBD only), not converted from a PhysX rigid asset. See the [Deformables guide](../../../docs/source/concepts/deformables.rst).1920Implicit MPM particle assets and rigid-MPM coupling are also out of scope; see the [Implicit MPM page](../../../docs/source/concepts/using_mpm.rst).2122## Workflow23241. **Multi-backend Asset Importing Pipeline.** Use provided Isaac Lab assets directly in PhysX and MJWarp; Newton parses their supported authored USD Physics and PhysX properties. For a new URDF or MJCF, keep `run_asset_transformer=True` and `run_multi_physics_conversion=True` so the importer creates neutral, PhysX, and MuJoCo payloads. Account for its nested rigid-body structure.252. **Use per-solver schema fragments.** Pass a list of fragments to each spawner field. Put common USD Physics properties in solver-common fragments such as `UsdPhysicsRigidBodyCfg`. Put MJWarp-specific fields in `Mujoco*Cfg`, Newton-native fields in `Newton*Cfg`, and PhysX-only fields in `Physx*Cfg`. Confirm support in the generated schema APIs.263. **Audit the authored mechanical model.** Check every dynamic link and contact-relevant object for intentional mass, COM, inertia and frames, collision geometry, approximation and scale, materials, articulation root, fixed-base and fixed-joint representation, joint axes and limits, self-collision, and gravity overrides.274. **Match contact and friction behavior.** Expect more default slip in MJWarp. Validate colliders, material bindings, contact locations and gripper force. Set per-shape `condim` with `MujocoCollisionCfg`, tune material friction, then set global `MJWarpSolverCfg(cone=..., impratio=...)`. Treat `priority`, `solmix`, `solref`, and `solimp` as expert per-collider overrides. Use fixed-grasp displacement, contact count, effort, penetration, and success metrics.285. **Velocity limits distinction.** `actuator_velocity_limit` is a rated speed and `joint_velocity_limit` is a requested solver clamp. Isaac Lab writes the latter to Newton's model, but MJWarp does not consume or enforce it; Kamino does. Add task or control checks for required speed bounds under MJWarp. Use `joint_effort_limit` for solver limits and `actuator_effort_limit` to clip explicit actuator models.296. **Why MJWarp often needs more armature.** Use reflected rotor inertia or controlled response tests for articulated coordinates. A plain rigid object has body inertia, not actuator armature. Correct mass, inertia, units, reset penetration, effort, action scale, control period, and contact capacity before changing armature.307. **Retune damping with armature.** Increasing armature changes effective inertia and damping ratio. Tune armature, stiffness, and damping together from a step response, use conservative action scales, and keep targets away from hard stops to prevent bang-bang control.318. **Choose an MJWarp starting profile.** Do not translate PhysX parameters numerically. Start from the nearest profile on the MJWarp solver page, keep the documented convergence defaults initially, enable `NewtonCfg.debug_mode`, and use MuJoCo contacts unless the task requires `NewtonCfg.collision_cfg`. Then run zero and random agents in PhysX and MJWarp through multiple resets. Check non-finite state, first-step impulses, saturation, excessive angular velocity, contact loss, and warnings. Reject penetrations, impossible mimic states, and invalid randomized geometry before stepping.329. **Diagnose MJWarp-only failures.** Reproduce the first bad step with one environment, a fixed state, no randomization, and identical actions. Classify initialization/model, contact/capacity, control, or dense-scene failures before tuning. Raise overflowing capacity first; change convergence settings only after the asset, reset, controller, contact model, and capacities are valid.3334## Validation3536Require an asset that parses into both backends with supported per-solver fields, intentional mass, collision and contact data, physically justified actuator parameters, finite task behavior, and valid resets. Do not classify an asset as ready while importer or solver warnings remain unexplained.3738## Maintenance3940Keep this skill synchronized section-for-section with the asset migration guide and use the MJWarp solver page for current profile values.4142## References4344- [Compact reference](reference.md)45- [Examples](examples.md)46- [Evaluations](evaluations.md)47- [MJWarp solver tuning](../../../docs/source/how-to/solver_tuning_mjwarp.rst)48- [Physics schemas: fragments and legacy configuration classes](../../../docs/source/concepts/schema_cfgs.rst)49- [Newton Simulation Tuning guide](https://newton-physics.github.io/newton/latest/concepts/simulation_tuning.html)