Is this page helpful?

[isaacsim.gui.property] Isaac Sim Property Extensions#

Version: 1.6.2

Overview#

The isaacsim.gui.property extension provides specialized property panel widgets for robotics workflows in Isaac Sim. It extends the USD Property Window with custom widgets designed specifically for editing robot-related schemas, arrays, custom data, and Isaac Sim-specific attributes on USD prims.

Key Components#

Robot Schema Widgets#

Robot API Schema Management: The RobotAPIWidget provides a property interface for managing Robot API schema on USD prims, allowing users to configure robot-specific properties like description, namespace, robot type, license, and version information.

Link and Joint Configuration: The LinkAPIWidget and JointAPIWidget handle link-specific and joint-specific properties respectively, including joint name overrides, degree of freedom configurations, and actuator settings for articulated robots.

Motion Planning Integration: The MotionPlanningAPIWidget exposes IsaacMotionPlanningAPI properties for configuring motion planning parameters and constraints directly in the property panel.

Specialized Data Widgets#

Array Property Management: The ArrayPropertiesWidget provides editing functionality for USD array-based attributes including integers, floats, and multi-dimensional vectors (int[], float[], int2[], float2[], int3[], float3[], int4[], float4[]). It creates dedicated editing windows where users can view, add, remove, and modify individual array elements with appropriate input fields based on the array’s data type.

Custom Data Editor: The CustomDataWidget offers a JSON text editor interface for viewing and modifying custom metadata stored on USD prims. It validates input in real-time and converts complex data types to lists for JSON compatibility while preserving original data structure.

Name and Namespace Management: The NameOverrideWidget and NamespaceWidget provide interfaces for managing name override and namespace attributes on prims that don’t have robot schema APIs, enabling alternative name searches and organizational categorization.

Context Menu Integration#

Each widget integrates with the property panel’s context menu system, automatically adding menu entries like “Isaac/Robot Schema/Robot API” or “Isaac/NameOverride” when appropriate prims are selected. The widgets intelligently show or hide based on prim selection and existing schema presence.

Extensibility#

The extension uses a base class approach with _RobotSchemaWidgetBase providing unified functionality for robot schema widgets. This pattern allows consistent behavior across different robot schema types while enabling specialized attribute handling for each schema variant.

All widgets implement singleton patterns to ensure only one instance exists per session, and they automatically handle schema application, removal, and property synchronization with the underlying USD stage.

Enable Extension#

The extension can be enabled (if not already) in one of the following ways:

Define the next entry as an application argument from a terminal.

APP_SCRIPT.(sh|bat) --enable isaacsim.gui.property

Define the next entry under [dependencies] in an experience (.kit) file or an extension configuration (extension.toml) file.

[dependencies]
"isaacsim.gui.property" = {}

Open the Window > Extensions menu in a running application instance and search for isaacsim.gui.property. Then, toggle the enable control button if it is not already active.