isaaclab_newton.sim.usd_export

isaaclab_newton.sim.usd_export#

Newton USD export and loading.

UsdExporter

Export a Newton scene environment: its USD plus every live model value Isaac Lab set after the build.

class isaaclab_newton.sim.usd_export.UsdExporter[source]#

Bases: BaseUsdExporter

Export a Newton scene environment: its USD plus every live model value Isaac Lab set after the build.

The base is Newton’s own import of the exported stage, without Isaac Lab: what a consumer of the file gets from USD alone. A value is written where Isaac Lab’s live model differs from it, so Isaac Lab’s builder defaults, its asset configuration and its other overrides are all stated, and nothing Newton’s import derives by itself is.

The file is meant for Newton’s USD import (newton.ModelBuilder.add_usd()) with the solver’s custom attributes registered and the Newton, PhysX and, for MuJoCo, MuJoCo schema resolvers. USD cannot yet state Newton’s substeps and collision pipeline settings, nor a joint target mode other than the one the import infers from the gains; the export warns about these. Terrain that Isaac Lab collides as a heightfield is imported as its mesh. Bodies and colliders added outside the USD, such as by a world builder hook, and collision switched there, are refused.

Attributes:

exports_cables

Operations.

Methods:

compute_diff(stage)

Return the live model values that differ from Newton's import of stage.

exports_cables: ClassVar[bool] = True#

Operations.

compute_diff(stage: pxr.Usd.Stage) → list[UsdEdit][source]#

Return the live model values that differ from Newton’s import of stage.

Parameters:

stage – The exported stage, reduced to the selected environment.

Returns:

Values to author so that Newton’s import reproduces the live model.