scene-gaussian-map-alignment

Scene Gaussian Map Alignment

Use this when a bundle combines a 3D Gaussian/splat/PLY/USD/OBJ scene, a robot map such as Nav2 YAML plus occupancy PGM, semantic anchors from navigation_memory.json, or an Isaac/operator-console report that must label evidence honestly.

Boundary

Keep stable, repeatable work in scripts. The skill owns the judgment that changes from scene to scene:

• Stable scripts parse headers, bounds, map metadata, semantic-memory JSON, transforms, smoke artifacts, images, and HTML reports.
• The skill decides the evidence tier, asks for missing assets, chooses which anchors are credible, names blockers, and prevents overclaiming.
• Do not hide scene-specific assumptions in a script default. If an assumption will vary with the next Gaussian scene, write it in the skill/report as an explicit decision.

Evidence Tiers

Use these labels consistently:

• blocked: geometry, map files, semantic anchors, or coordinate evidence are missing.
• candidate: bbox fit, scale/translate, manual placement, or another heuristic alignment exists.
• verified: named physical/semantic anchors match across map and scene with residuals recorded.
• runtime_proven: Isaac or robot-view smoke renders/navigates through candidate waypoints and writes view evidence.
• planner_backed: a real planner/Nav2-equivalent path proof exists.

Never skip tiers in wording. A runtime smoke can prove that rendered robot views exist at candidate poses; it does not by itself prove Nav2 planner parity.

Workflow

1. Inventory every asset before aligning: Gaussian/splat/PLY files and whether they are rendered or only inspected, USD/OBJ/mesh world bounds, Nav2 YAML, occupancy grid, semantic memory, map-bundle context, anchor ids, and any segmentation/object manifest/correspondence/calibration evidence.

2. Run the deterministic tools that apply to the available assets:

   python -m roboclaws.household.agibot_map_bundle \
     --source-map-dir <map-root> \
     --context-json <context-json> \
     --output-dir assets/maps/<bundle-name>
   
   .venv-isaaclab/bin/python -m roboclaws.backends.isaaclab.b1_readiness \
     --b1-root <scene-root> \
     --map12-root <map-root> \
     --output output/<run>/readiness.json
   
   .venv-isaaclab/bin/python -m roboclaws.backends.isaaclab.b1_navigation_smoke \
     --b1-root <scene-root> \
     --map12-root <map-root> \
     --output-dir output/<run> \
     --accept-nvidia-eula
   
   .venv-isaaclab/bin/python -m roboclaws.backends.isaaclab.b1_readiness \
     --b1-root <scene-root> \
     --map12-root <map-root> \
     --navigation-artifact output/<run>/navigation_smoke.json \
     --require-navigation-success \
     --output output/<run>/readiness_with_navigation.json
   
   python -m roboclaws.backends.isaaclab.b1_navigation_report \
     --run-dir output/<run>