Skip to content

Struct burst_capture_event_t

ClassList > burst_capture_event_t

One captured burst's event, as events() hands it back.More...

  • #include <burst_capture_core.h>

Public Attributes

Type Name
double cn0_dbhz_est
double doppler_hz_est
double doppler_rate_hz_s
double doppler_res_hz
uint64_t preamble_start

Detailed Description

push() returns the SAMPLES of every burst it completed, concatenated; this is the parallel record for row i of that return. It exists because a single push() can complete many bursts and each one needs its own event a single set of scalar read-backs would describe only the last (docs/design/dsss-burst-receiver.md ยง4: the record must be sufficient on its own, for EVERY burst, not just the most recent).

Everything here is acquisition's or refine's. A consumer's own estimates (a demodulator's residual frequency, its post-decode SNR) belong to the consumer's record, not to this one.

Public Attributes Documentation

variable cn0_dbhz_est

double burst_capture_event_t::cn0_dbhz_est;

C/N0 lower bound from the hit, dB-Hz.


variable doppler_hz_est

double burst_capture_event_t::doppler_hz_est;

Signed coarse Doppler, Hz.


variable doppler_rate_hz_s

double burst_capture_event_t::doppler_rate_hz_s;

Refine's winning rate hypothesis, Hz/s: the rate whose de-chirp made the whole preamble's coherent sum largest at preamble_start. One of refine's R grid points from -doppler_rate to +doppler_rate, spaced 2*doppler_rate/(R - 1); 0 without a declared rate (doppler_rate 0). Refine searches the grid whenever a rate is declared, with one acquisition hypothesis or many (doppler#2219). A hypothesis, not a fit, from the whole preamble rather than one dwell: it is the grid point nearest the carrier's rate in every event 23 dB over the design point, on or off the grid. At the design point it is in 82% to 89% of events whose rate is ON a grid point, but in 51% of those 0.4 of a step off one, where the neighbouring point is only 0.6 of a step away (validate_acq_rate_pd's event-rate rows; docs/design/burst-capture.md). Appended last, so positional initialisers do not shift (doppler#2219).


variable doppler_res_hz

double burst_capture_event_t::doppler_res_hz;

Acquisition's native bin width, Hz.


variable preamble_start

uint64_t burst_capture_event_t::preamble_start;

Exact stream position of the preamble.



The documentation for this class was generated from the following file native/inc/doppler/burst_capture/burst_capture_core.h