Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Contributing — New Assets

Asset Types Overview

The Space Robotics Bench categorizes assets into three main types:

Asset TypeDescription
SceneryEnvironmental elements like terrain and structures
ObjectsInteractive objects, tools, and payloads
RobotsSystems that are intended to be controlled

Static Assets

Contribute SRB-owned static payloads through the srb_assets repository; SRB also uses Isaac Lab assets. Before submission:

  • Identify its family and required interface (for example, robot joints and sensors, terrain source metadata, or object spawn configuration).
  • Record source, author, and license attribution in the applicable metadata catalog; for assets listed in SRB’s asset catalog, use docs/data/assets.toml.
  • Follow the family’s format and validation requirements. For example, terrain rocks are checksum-verified, decoded, bounded, and cleaned by the rock pipeline; robot and scenery checks differ.
  • Check that dependencies, payload paths, and references follow the family conventions before submission.

Add the asset to your srb_assets fork and submit a pull request.

Procedural Assets with SimForge

SimForge provides procedural environments and assets. SRB also includes procedural USD generators, including robot structures. Examples:

See the SimForge documentation, especially: