docs: add visualization conventions and update visualizer defaults

This commit is contained in:
2026-02-08 07:38:23 +00:00
parent d07c244817
commit dc2d34dd7c
9 changed files with 392 additions and 7 deletions
@@ -0,0 +1,6 @@
## Semantic Priority in detect_ground_face
- Decision: Explicitly check for 'bottom' face in and return it immediately if any of its markers are visible.
- Rationale: For the , the 'bottom' face is guaranteed to be the ground. Geometric heuristics might pick other faces (like 'front' or 'back') if they happen to align better with the camera's 'up' vector due to camera tilt or marker placement.
## Semantic Priority in detect_ground_face
- Decision: Explicitly check for 'bottom' face in face_marker_map and return it immediately if any of its markers are visible.
- Rationale: For the standard_box_markers_600mm.parquet, the 'bottom' face is guaranteed to be the ground. Geometric heuristics might pick other faces (like 'front' or 'back') if they happen to align better with the camera's 'up' vector due to camera tilt or marker placement.
@@ -0,0 +1,6 @@
## Ground Face Heuristic Priority
- Prioritizing semantic face names (specifically 'bottom') over purely geometric dot-product heuristics significantly improves robustness for marker parquets with named faces.
- Geometric heuristics can be noisy due to marker frame orientation or slight misalignments.
## Ground Face Heuristic Priority
- Prioritizing semantic face names (specifically 'bottom') over purely geometric dot-product heuristics significantly improves robustness for marker parquets with named faces.
- Geometric heuristics can be noisy due to marker frame orientation or slight misalignments.