Skip to main content

Module truth

Module truth 

Source
Expand description

Ground-truth oracle for the simulation harness.

Unlike crate::score, which compares a live recording against an offline retrack of itself, this module scores a .braidz against the known ground truth of the Scenario that generated it. Because the world is a pure function of time (World::state_at), every reconstructed track can be compared to where its insect actually was.

It answers: how accurately, how completely, and how stably did Braid track the simulated insects?

  • Accuracy: position RMSE / max error over matched object-frames.
  • Completeness (coverage): the fraction of object-frames where an insect was present and some track was within the association gate.
  • Stability: ID switches and track fragmentation — how many distinct Braid obj_ids ended up assigned to a single ground-truth insect. A perfectly stable run has one obj_id per insect (mean fragments = 1, zero switches); the live-vs-retrack fragmentation bug shows up here as many fragments per insect.

Structs§

GroundTruthScore
Result of scoring a .braidz against ground truth.

Functions§

score_against_truth
Score braidz_path against the ground truth of scenario.