Skip to main content

Module clock_discipline

Module clock_discipline 

Source
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§

CrossClockMapping
Explicit cross-clock mapping between two distinct clock origins (source_origin -> target_origin) over a half-open source validity interval [valid_from, valid_until).
LeapSecondStep
One step in an authenticated IERS/BIPM TAI-minus-UTC leap-second schedule.
LeapSecondTable
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.
QualifiedIqSample
Complex baseband sample with explicit carrier convention, carrier frequency, reference phase, and signed baseband frequency offset.

Enums§

ClockDisciplineError
ClockScale
Clock scale defined by Shared Schema 1 (Clock.scale).
IqCarrierConvention
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 QualifiedIqSample to target_convention and optional target_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::Clock instances share the exact same origin, restart epoch, scale, epoch, and tick rate before admitting an unmapped same-clock join (C02-C03).