Skip to content

Validation And Simulation Contracts

Receiver validation and simulation prove receiver-boundary behavior. They compare runtime outputs to reference truth, exercise synthetic receiver flows, and package validation reports that explain runtime decisions. They do not own repository artifact layout or the original truth sources.

Proof Flow

flowchart LR
    truth["reference truth<br/>testkit or fixture"]
    runtime["receiver run<br/>acquisition tracking observations"]
    compare["reference validation<br/>alignment and budgets"]
    report["validation report<br/>runtime evidence"]
    consumers["tests, command reports,<br/>infra inspectors"]

    truth --> compare
    runtime --> compare --> report --> consumers

Contract Families

family receiver-owned surface reader promise
reference alignment reference-validation source receiver outputs can be compared to reference epochs without repository policy
validation reports validation-report source runtime decisions, budgets, and integrity classifications stay typed
validation helpers validation-helper source and report builders receiver evidence can be summarized without hiding stage meaning
synthetic execution synthetic simulation source synthetic scenarios exercise acquisition, tracking, observations, and artifacts through the receiver boundary
covariance realism covariance-realism source when navigation support is enabled covariance claims remain tied to receiver-produced evidence

Boundary Decisions

  • Truth fixtures may come from bijux-gnss-testkit, but receiver validation owns how runtime outputs are aligned and judged.
  • Persisted artifact layout and repository inspection belong to infra after receiver artifacts exist.
  • Signal and navigation crates own their scientific primitives; receiver simulation owns the runtime scenario that combines them.
  • A validation report is a receiver contract when it explains runtime behavior, not merely because a test happens to use it.

First Proof Check

Inspect the receiver reference-validation guide, simulation guide, and receiver test guide. Then inspect reference-validation source, validation-report source, synthetic simulation source, and focused integration tests for navigation validation runs and synthetic receiver execution.