Tracking & synchronization¶

Loop filters, carrier and timing recovery, and the narrowband receivers built on them.

Python module doppler.track. Area: Synchronization.

Classes and functions¶

Name	Kind	API	Guide	Gallery	Example	Design
`BpskReceiver`	class			Capturing All Receiver Telemetry	mpsk_telemetry_capture_demo	MPSK Receiver API taxonomy: the DSP building-block hierarchy and its naming axis
`CarrierMpsk`	class	CarrierMpsk		M-PSK Carrier Loop — Theory Validation NDA Carrier Loop — Theory Validation M-PSK constellation (Gray-coded map / demap)	mpsk_carrier_theory_demo	MPSK Receiver API taxonomy: the DSP building-block hierarchy and its naming axis The NCO
`CarrierNda`	class	CarrierNda	Lock Detection Across `doppler.track`	NDA Carrier Loop — Theory Validation	carrier_nda_seeding_demo mpsk_nda_theory_demo	MPSK Receiver API taxonomy: the DSP building-block hierarchy and its naming axis Lock Detection — the reasoning +1 more
`Costas`	class	Costas	Lock Detection Across `doppler.track`	Carrier Loop Stress Code Loop Tracking Costas Loop — Theory Validation +3 more	costas_demo costas_theory_demo receiver_lock_demo	API taxonomy: the DSP building-block hierarchy and its naming axis AsyncDsssReceiver and AsyncDsssPool — continuous DSSS, from spec to object Lock Detection — the reasoning +1 more
`Dll`	class	Dll	Lock Detection Across `doppler.track` DSSS Burst Acquisition	Code Loop Tracking DLL Code Loop — Theory Validation Full-Chain Lock-Up +4 more	async_despread_demo dll_demo dll_theory_demo +2 more	MPSK Receiver SymbolSync Timing Lock Detector API taxonomy: the DSP building-block hierarchy and its naming axis +5 more
`LoopFilter`	class	LoopFilter		Carrier Loop Stress Code Loop Tracking M-PSK Carrier Loop — Theory Validation	loop_filter_bandwidth_demo mpsk_nda_theory_demo	The Loop Filter API taxonomy: the DSP building-block hierarchy and its naming axis
`MpskReceiver`	class		Lock Detection Across `doppler.track` Waveforms — what you can generate	Arbitrary-Rate Symbol Recovery M-PSK Receiver — Performance Characterisation M-PSK Receiver — Pull-in, Lock, and BER +3 more	framed_link_demo mpsk_doppler_profile_demo mpsk_receiver_demo +2 more	MPSK Receiver Receiver Test Harness Symbol Timing on a Rate Cascade +7 more
`MpskReceiverR`	class			M-PSK Receiver — Performance Characterisation M-PSK Receiver — Pull-in, Lock, and BER	mpsk_receiver_performance_demo	MPSK Receiver API taxonomy: the DSP building-block hierarchy and its naming axis Lock Detection — the reasoning +1 more
`RateSync`	class	RateSync		Arbitrary-Rate Symbol Recovery M-PSK Receiver — Pull-in, Lock, and BER	ratesync_demo	MPSK Receiver Symbol Timing on a Rate Cascade The Loop Filter +2 more
`SymbolSync`	class	SymbolSync	Lock Detection Across `doppler.track`	Arbitrary-Rate Symbol Recovery Full-Chain Lock-Up Symbol Timing Recovery +1 more	receiver_lock_demo symsync_demo symsync_theory_demo	MPSK Receiver Symbol Timing on a Rate Cascade SymbolSync Timing Lock Detector +2 more

Guide pages in this domain¶

Lock Detection Across doppler.track — which configure_lock to call, and why, for every tracking loop

Gallery pages in this domain¶

Arbitrary-Rate Symbol Recovery — matched filtering and symbol timing in one dot product, at a non-integer samples-per-symbol.
Carrier Loop Stress — Costas loop pull-in under noise.
Code Loop Tracking — delay-locked loop code tracking.
Costas Loop — Theory Validation — loop-filter design and steady-state behaviour.
DLL Code Loop — Theory Validation — discriminator and loop-filter derivation.
Full-Chain Lock-Up — Dll -> Costas -> SymbolSync cold-started with no code, carrier, or timing knowledge, watched over one shared Telemetry context.
Lock Detection: Verify Counts + Hysteresis — level + time hysteresis vs. a naive comparator on a marginal signal.
M-PSK Carrier Loop — Theory Validation — decision-directed carrier recovery.
M-PSK Receiver — Performance Characterisation — EVM, SER, lock time, false alarm and level invariance over random geometries.
M-PSK Receiver — Pull-in, Lock, and BER — integrated carrier + timing + bit recovery.
M-PSK Receiver — Sizing the Carrier Loop, and Riding a Doppler Profile — sizing bn_carrier for a predictable acquisition, and what a step and two ramps actually cost.
NDA Carrier Loop — Theory Validation — non-data-aided carrier recovery.
Symbol Timing Recovery — timing-error-detector-driven resampling.
Timing Loop — Theory Validation — the timing loop's transfer function.

Design pages in this domain¶

MPSK Receiver — streaming M-PSK receiver architecture and carrier-recovery design, the constellation primitive it reuses (§9, soft decisions included), and the record of the collapse that made the real face a view (§12)
Receiver Test Harness — inventory of the stimulus, measurement and gate layers a receiver measurement rests on, and where they do not yet meet
Symbol Timing on a Rate Cascade — RateSync: why the matched filter and the interpolator are one dot product, why ctrl is referenced to the terminal stage's rate, and why the T/2 parity resolves itself
SymbolSync Timing Lock Detector — SymbolSync's Gardner/DTTL lock statistic and sizing formula
The Loop Filter — the second-order PI every tracking loop in the library embeds by value: where its gains come from, the unit condition its bn promise depends on, and what it deliberately does not bound

Used in other domains¶

Pages filed under another domain that name a symbol of this module, or link to or from a page filed here: a class used for another task is found from both sides, never re-filed.