How ros-claw/simscene works
SimScene is an agent-facing Isaac Sim scene-building and simulation product: users discover and inspect online assets, acquire and prepare selected models, compose editable USD scenes, run physical cases, assess observations, and deliver traceable films. The graph preserves the documented catalog, preparation, optional generation, recipe, robotics, simulation, verification, and video capabilities. Source excerpts are selective; edges use README workflow statements or indexed references, so unsampled implementation details are not expanded into speculative call chains.
Main entry points: isaac_run.py Isaac execution · search.py Asset catalog · worker.py Preparation worker · dispatch.py Asset acquisition
Components 30
Asset discovery and preparation
- Asset catalog
src/simscene/catalog/search.py - Catalog facade
src/simscene/catalog/service.py - Catalog metadata
src/simscene/catalog/models.py - Catalog providers
src/simscene/catalog/providers - Asset acquisition
src/simscene/acquisition/dispatch.py - Asset cache
src/simscene/cache.py - Preparation jobs
src/simscene/preparation/jobs.py - Preparation worker
src/simscene/preparation/worker.py - Sand3D generation
src/simscene/generation/backend_worker.py
Scene authoring
- Scene recipes
src/simscene/recipes - Editable scene
src/simscene/scene.py - Robotics profiles
src/simscene/robotics/profiles.py - Asset physics binding
src/simscene/physics_binding.py
Simulation runtime
- Isaac execution
src/simscene/worker/isaac_run.py - Mechanism runtime
src/simscene/worker/mechanism.py - Case execution
src/simscene/verification/case_runner.py
Verification and integrity
- Mechanism checks
src/simscene/verification/mechanism.py - D6 mechanism checks
src/simscene/verification/mechanism_v2.py - Passive network checks
src/simscene/verification/passive_network.py - D6 network checks
src/simscene/verification/passive_network_v3.py - Structural load checks
src/simscene/verification/structural_loads.py - D6 admission
src/simscene/verification/d6_admission.py - Run input integrity
src/simscene/run_integrity.py - Asset snapshot integrity
src/simscene/snapshot_integrity.py - Output hash checks
src/simscene/evidence_integrity.py
Agent access and delivery
- MCP tools
src/simscene/mcp_server.py - Capture and video
src/simscene/capture.py
Other components
- Agent / user
- Online asset sources
- Isaac Sim host
Connections 31
- Agent / user → MCP tools: requests tools
README.md - MCP tools → Catalog facade: exposes search
src/simscene/catalog/service.py - Catalog facade → Asset catalog: searches assets
src/simscene/catalog/service.py - Asset catalog → Catalog metadata: returns metadata
src/simscene/catalog/search.py - Asset catalog → Catalog providers: queries providers
src/simscene/catalog/search.py - Catalog providers → Online asset sources: retrieves listings
README.md - Agent / user → Asset acquisition: selects assets
README.md - Asset acquisition → Asset cache: stores downloads
- Agent / user → Preparation jobs: prepares selection
README.md - Preparation jobs → Preparation worker: runs job
src/simscene/preparation/jobs.py - Preparation worker → Asset acquisition: acquires selection
src/simscene/preparation/worker.py - Preparation worker → Asset physics binding: uses bindings
src/simscene/preparation/worker.py - Agent / user → Sand3D generation: requests generation
README.md - Agent / user → Scene recipes: reuses recipes
README.md - Agent / user → Editable scene: composes scene
README.md - Editable scene → Asset physics binding: validates assets
src/simscene/scene.py - Agent / user → Robotics profiles: configures robots
- Agent / user → Isaac execution: runs simulation
README.md - Isaac execution → Isaac Sim host: executes physics
README.md - Isaac execution → Case execution: runs case
src/simscene/worker/isaac_run.py - Isaac execution → Mechanism runtime: observes mechanisms
src/simscene/worker/isaac_run.py - Agent / user → Mechanism checks: checks observations
README.md - Agent / user → Passive network checks: checks handoffs
README.md - Agent / user → Structural load checks: checks loads
README.md - D6 mechanism checks → D6 admission: checks admission
src/simscene/verification/mechanism_v2.py - D6 network checks → D6 admission: checks admission
src/simscene/verification/passive_network_v3.py - Agent / user → Run input integrity: checks run locks
README.md - Run input integrity → Asset snapshot integrity: checks snapshots
src/simscene/run_integrity.py - Agent / user → Output hash checks: seals outputs
README.md - Agent / user → Capture and video: records simulation
README.md - Capture and video → Isaac Sim host: captures frames
README.md