Expand description
Clock-discipline verification, TAI/UTC leap-second table binding, sinusoidal phase
uncertainty bounds ($\Delta\phi_{\max} = 2\pi f u_t$, C02-C03), and explicit I/Q carrier
convention conversion (z_QAC = conj(z_EMF), C02-C08).
Structs§
- Cross
Clock Mapping - Explicit cross-clock mapping between two distinct clock origins (
source_origin -> target_origin) over a half-open source validity interval[valid_from, valid_until). - Leap
Second Step - One step in an authenticated IERS/BIPM TAI-minus-UTC leap-second schedule.
- Leap
Second Table - Authenticated, bounded TAI/UTC leap-second table with validity horizon and clock uncertainty. Per C02-C03, POSIX/UTC-to-TAI mapping requires an identified leap-second table and uncertainty; no floating global epoch or fixed universal UTC offset substitutes for it.
- Qualified
IqSample - Complex baseband sample with explicit carrier convention, carrier frequency, reference phase, and signed baseband frequency offset.
Enums§
- Clock
Discipline Error - Clock
Scale - Clock scale defined by Shared Schema 1 (
Clock.scale). - IqCarrier
Convention - Explicit I/Q complex carrier reconstruction conventions (C02-C08, CROSS-A04).
Constants§
- LEAP_
SECOND_ TABLE_ DOMAIN - Domain separator for BLAKE3 leap-second table commitments.
- MAX_
LEAP_ SECOND_ ENTRIES - Maximum entries in a zero-heap bounded TAI-UTC leap-second table.
Functions§
- compute_
phase_ uncertainty_ rad - Compute the sinusoidal phase uncertainty bound $\Delta\phi_{\max} = 2\pi f u_t$ in radians (C02-C03) for a carrier or analysis frequency $f > 0$ Hz and time uncertainty $u_t \ge 0$ s.
- convert_
iq_ sample_ between_ conventions - Explicitly convert a
QualifiedIqSampletotarget_conventionand optionaltarget_phase_origin_shift_seconds($\Delta t_0 = t_{0,\text{target}} - t_{0,\text{source}}$) per C02-C08: - reject_
unconjugated_ iq_ memcpy - Guard against direct raw
memcpy/ re-labeling of I/Q samples across conventions (C02-C08). - verify_
phase_ coherent_ join - Admit a phase-coherent join across RF I/Q (EMF Mode 0x0105) or ultrasound/acoustic array streams (QAC Mode 0x0107) only when the clock domain matches (or is explicitly mapped), time uncertainty $u_t$ is known, and $\Delta\phi_{\max} = 2\pi f u_t \le \Delta\phi_{\text{budget}}$.
- verify_
same_ clock_ join - Verify that two
acquisition::Clockinstances share the exact same origin, restart epoch, scale, epoch, and tick rate before admitting an unmapped same-clock join (C02-C03).