novaphy.UsdStageData

Snapshot of a parsed USD stage. Returned by OpenUsdImporter.import_file and consumed by SceneBuilderEngine.build_from_openusd.

Attributes

Attribute	Description
default_prim	Raw name/token from the stage's defaultPrim metadata (commonly "World"), not a prim path. May be empty when the stage does not declare one.
up_axis	Parsed stage up-axis token ("Y" or "Z").
meters_per_unit	Parsed stage unit metadata, in meters per authored unit.
prims	List of UsdPrim entries describing rigid bodies, shapes, and reference frames. Animation tracks live inside each prim's tracks field, not on the stage.

Example

import novaphy

stage = novaphy.OpenUsdImporter(min_supported_version=1.0).import_file("scene.usda")

if stage.up_axis == "Z":
    print("Z-up scene; NovaPhy uses Y-up internally — gravity must be set explicitly.")

for prim in stage.prims:
    print(prim.path, prim.type_name)

Notes

• default_prim, up_axis, meters_per_unit, and prims are writable Python attributes. Mutating a parsed object does not edit the source file.
• SceneBuilderEngine.build_from_openusd currently records neither up_axis nor meters_per_unit in its build transform. It consumes UsdPrim.local_transform values directly, so callers must apply any axis/unit conversion before building.

See Also

• OpenUsdImporter
• UsdPrim
• SceneBuilderEngine