Tutorial 3
June 8, 2026 · View on GitHub
Kinds: spoof + hybrid · Scenarios: scenarios/spoof-attack.toml,
scenarios/hybrid-pnt.toml (teaching copies:
scenarios/security.toml,
scenarios/hybrid.toml) · Difficulty: intermediate ·
~35 min
The capstone. You will run a spoofing-detector scenario and a full fused PNT suite, and learn to read security, integrity, and dead-reckoning together — the whole thesis: quantum inertial + optical timing buy resilience GNSS denial would otherwise take away.
Part A — Security: catching a time spoof
An attacker injects a slowly-ramping false GNSS time (0.1 ns/s, starting at t = 60 s).
The receiver cross-checks the asserted time against its own clock’s coasted
prediction and flags the spoof when the discrepancy passes the detection bound. The
detector is a two-sided χ²₁ / Neyman–Pearson energy test; the Security figure of
merit is 1 − P_md at the spec-sized (20 ns) spoof magnitude.
cargo run -- scenarios/spoof-attack.toml
Summary:
scenario 2b6bd22c3b80 | spoof LinearRamp { rate_ns_per_s: 0.1 } vs 20.000 ns spec (P_fa 0.010) | quantum security 1.000 (P_md 0.000, MC 0.000) detected 70s | classical security 0.558 (P_md 0.442, MC 0.444) detected 430s
- Quantum:
security 1.000, detected at 70 s. The optical clock’s detection floor is a fraction of a nanosecond, so it flags the spoof almost immediately — far below the 20 ns spec. - Classical:
security 0.558, detected at 430 s. The CSAC’s own coast noise over the window is comparable to 20 ns, so it often can’t tell the spoof from its own drift — it misses 44 % of the time.
The non-circular oracle: analytic vs Monte-Carlo P_md
The detector’s missed-detection probability is computed two independent ways that
must agree: a closed-form χ²₁ tail (the Neyman–Pearson result) and a
Monte-Carlo estimate. For the CSAC the analytic P_md is 0.442 and the MC P_md
is 0.444 — they agree to 0.002, well inside the ~few × 1/√N sampling error.
For the optical clock both are 0.000. Two separate computations of the same
probability agreeing is the non-circular cross-check (Kay, Fundamentals of
Statistical Signal Processing: Detection Theory; standard NP / χ² detection).
tests/tutorials.rs::tutorial3_spoof_analytic_matches_montecarlo asserts
|analytic_pmd − mc_pmd| < 0.05 for both clocks and quantum security_fom > 0.9.
Part B — Hybrid PNT: the full fused suite
Now the capstone scenario fuses a clock + a cold-atom IMU + optical inter-satellite time-transfer aiding (quantum suite) against CSAC + nav-grade IMU + RF (classical suite), through the same 1.8 h GNSS outage, against a 20 ns timing spec and a 100 m position spec.
cargo run -- scenarios/hybrid-pnt.toml
Summary:
scenario f33d734ecc51 | quantum PNT-holdover 6600s (t 6600s/p 6600s) integrity 0.998 security 0.997 | classical PNT-holdover 350s (t 6600s/p 350s) integrity 1.000 security 0.000
Read the (t …/p …) split — timing holdover vs position holdover:
- Quantum: PNT-holdover 6600 s — holds both timing (t 6600 s) and position (p 6600 s) for the whole outage.
- Classical: PNT-holdover 350 s — timing holds the full 6600 s (t 6600 s), because optical inter-satellite time-transfer keeps even the classical clock locked. The suite is position-limited at p 350 s: the nav-grade IMU is the weak link. This is the fusion thesis — isolate the classical suite’s failure to its inertial sensor.
integrity 0.998for the quantum suite is real and is not a bug. It is the filter’s self-consistency over noisy resync — not an aviation HPL/VPL integrity figure. Don’t over-read the word “integrity” here; seedocs/INTEGRITY.md.
The non-circular oracle: the 350 s position-holdover
The 350 s figure is dead-reckoning physics, not a fitted number. A constant
accelerometer bias b drives position error as ½·b·T². Crossing the 100 m spec:
Nav-grade (classical), b = 1.57e-3 m/s^2:
T = sqrt(2 * 100 / 1.57e-3) = 357 s -> ~350 s on the time grid
Cold-atom (quantum), b = 5.88e-7 m/s^2 (Templier et al. 2022, arXiv:2209.13209):
T = sqrt(2 * 100 / 5.88e-7) = 18,440 s >> 6600 s outage -> holds the full outage
Authoritative law: Groves, Principles of GNSS, Inertial, and Multisensor Integrated Navigation (2nd ed.), dead-reckoning error growth. These two ½bT² values bracket the engine’s 350 s / 6600 s split exactly — a closed-form physics check, external to the filter.
You can see the inertial weak link directly in the dead-reckoning scenario
(scenarios/inertial.toml, kind inertial):
quantum holdover 6600s p95 41.39m | classical holdover 350s p95 30629.9m — the
nav-grade sensor diverges to tens of kilometres.
How to read the three figures together
| Figure | What it means here | What it does not mean |
|---|---|---|
| Security | analytic spoof-detectability bound (1 − P_md) for a configured attack | not a multi-satellite RAIM detector |
| Integrity | filter self-consistency (samples inside the k-σ bound) | not aviation HPL/VPL/RAIM integrity |
| PNT-holdover | time in spec after GNSS loss, split into timing and position | not a 2-D CEP/2DRMS accuracy |
The genuine receiver-autonomous integrity — real HPL/VPL with alert limits and a
Stanford diagram — lives in the integrity pack
(scenarios/integrity.toml); that’s the Tier-3 reading
exercise.
What the tests pin
tutorial3_spoof_analytic_matches_montecarlo— analytic vs MC P_md agree to < 0.05 for both clocks;quantum security_fom > 0.9.- The hybrid summary numbers (6600 s / 350 s) are bracketed by the ½bT² oracle above;
the inertial split is pinned through the teaching scenario in
annotated_tutorial_scenarios_runand the Tutorial-1/2 headline tests.
Pitfalls and units
- Timing FoM is nanoseconds; position FoM is metres and 1-DOF (single-axis, not CEP/2DRMS).
integrity 0.998is self-consistency, not aviation integrity.- The classical suite’s timing survives only because of optical time-transfer
aiding — read the
(t …/p …)split, not just the headline PNT-holdover.
Where next
- Run the honest-failure case: the
lunar-integritypack reports a south-pole ARAIM pass where protection levels exceed the alert limit (HPL 263–452 m > 50 m), so the system is reported unavailable — a feature, not a bug. - Defend a result: do the Tier-3 exercise — Monte-Carlo bands, reproducibility, and reading a protection level.