docs: add visualization conventions and update visualizer defaults

2026-02-08 07:38:23 +00:00
parent d07c244817
commit dc2d34dd7c
9 changed files with 392 additions and 7 deletions
@@ -0,0 +1,3 @@
+## Decisions
+- Use `--diagnose` in `visualize_extrinsics.py` to verify world-frame orientation.
+- Prefer explicit `--ground-face` over heuristic detection to avoid 90-degree flips.
@@ -0,0 +1,5 @@
+## Ground Plane Orientation Analysis
+- `calibrate_extrinsics.py` uses `--auto-align` to rotate the world frame.
+- Alignment maps a detected face normal to `[0, 1, 0]` (Y-up).
+- Heuristic detection (`detect_ground_face`) depends on camera being roughly upright.
+- `inside_network.json` uses a world frame where the ground is at Y=0 and cameras have specific offsets (e.g., -1.17m Y).