new_scene
Discard the current stage and unsaved changes, then open an empty USD stage with a chosen up axis and meters-per-unit scale. Save first to keep your work.
Instructions
Discard the open stage, unsaved changes included, and open an empty one in the up axis and units asked for, with a /World Xform as its default prim.
The stage is Z-up in metres when left out: the frame of Isaac Sim's own new stage, its robots, SimReady assets and most robotics scenes, so scripts, payloads and physics written for them need no conversion. up_axis="Y" makes a Y-up stage, as USD Composer's are, and meters_per_unit=0.01 one in centimetres. The answer gives the stage's up_axis and meters_per_unit as read back. Kit places the viewport's camera for the units of its app's own new stages, so in other units place it with set_camera. Call save_scene first to keep the old one. The new stage has no file, so save_scene needs a file_path for it. A recording that runs stops taking frames, and draw_debug's drawings go.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "new_scene"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| up_axis | No | The stage's up axis: Z, as Isaac Sim's robots and stages are, or Y | Z |
| meters_per_unit | No | The stage's metres per unit: 1.0 for metres, 0.01 for centimetres |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |