Struct TrackingLoopScenario 

pub struct TrackingLoopScenario {

    pub pll_bandwidth_hz: f64,
    pub dll_bandwidth_hz: f64,
    pub predetection_integration_s: f64,
    pub correlator_spacing_chips: f64,
    pub carrier_allowance_deg: f64,
    pub code_allowance_chips: Option<f64>,
    pub pullin_bandwidth_ratio: f64,
    pub drop_confirm_epochs: usize,
    pub relock_confirm_epochs: usize,
    pub doppler_rate_hz_per_s: f64,
    pub code_slew_chips_per_s: f64,
    pub cn0_high_dbhz: f64,
    pub cn0_low_dbhz: f64,
    pub ramp_duration_s: f64,
    pub jitter_table_cn0_dbhz: Vec<f64>,
    pub jammer_power_dbw: f64,
    pub jammer_gain_dbi: f64,
    pub rx_gain_toward_jammer_db: f64,
    pub rx_gain_toward_sat_db: f64,
    pub signal_power_dbw: f64,
    pub temp_k: f64,
    pub freq_hz: f64,
    pub chip_rate_hz: f64,
    pub jammer_type: String,
    pub q_override: Option<f64>,
    pub denial_js_threshold_db: f64,
    pub capture_js_threshold_db: f64,
    pub spoof_code_slew_chips_per_s: Vec<f64>,
    pub spoof_doppler_rate_hz_per_s: Vec<f64>,
}

A tracking-loop loss-of-lock scenario. Every field is defaulted, so a body of only kind = "tracking-loop" reproduces the reference configuration.

Fields

pll_bandwidth_hz: f64

Carrier (Costas) loop one-sided noise bandwidth (Hz).

dll_bandwidth_hz: f64

Code (DLL) loop one-sided noise bandwidth (Hz).

predetection_integration_s: f64

Predetection coherent integration time (s).

correlator_spacing_chips: f64

Early-to-late correlator spacing (chips).

carrier_allowance_deg: f64

Carrier 3σ + θ_e allowance (degrees); the 45° three-sigma form of the 15° rule.

code_allowance_chips: Option<f64>

Code 3σ + lag allowance (chips). Absent ⇒ half the correlator spacing, the discriminator’s linear half-range.

pullin_bandwidth_ratio: f64

Bandwidth multiplier applied when re-pulling-in after a loss of lock. This is what makes the re-lock threshold higher than the drop threshold.

drop_confirm_epochs: usize

Consecutive sub-threshold epochs required before lock is declared lost.

relock_confirm_epochs: usize

Consecutive above-threshold epochs required before lock is re-declared.

doppler_rate_hz_per_s: f64

Carrier Doppler rate the loop must follow while tracking (Hz/s).

code_slew_chips_per_s: f64

Code slew the loop must follow while tracking (chips/s).

cn0_high_dbhz: f64

C/N₀ the profile starts and ends at (dB-Hz).

cn0_low_dbhz: f64

C/N₀ at the bottom of the profile (dB-Hz).

ramp_duration_s: f64

Duration of each leg of the down-then-up C/N₀ ramp (s).

jitter_table_cn0_dbhz: Vec<f64>

C/N₀ values the jitter table is tabulated at (dB-Hz).

jammer_power_dbw: f64

Jammer transmit power (dBW).

jammer_gain_dbi: f64

Jammer antenna gain toward the victim (dBi).

rx_gain_toward_jammer_db: f64

Receive-antenna gain toward the jammer (dB).

rx_gain_toward_sat_db: f64

Receive-antenna gain toward the satellite (dB).

signal_power_dbw: f64

Isotropic received signal power (dBW).

temp_k: f64

Receiver system noise temperature (K).

freq_hz: f64

Carrier frequency (Hz).

chip_rate_hz: f64

Spreading-code chip rate (chips/s).

jammer_type: String

Jammer spectrum class fed to q_factor: broadband, narrowband/cw, swept.

q_override: Option<f64>

Override the spectral-separation coefficient Q.

denial_js_threshold_db: f64

The existing power-ratio denial criterion (dB of J/S). Reported unchanged.

capture_js_threshold_db: f64

The existing power-ratio spoof-capture criterion (dB of J/S).

spoof_code_slew_chips_per_s: Vec<f64>

Code slew axis of the spoof pull-in map (chips/s).

spoof_doppler_rate_hz_per_s: Vec<f64>

Carrier Doppler rate axis of the spoof pull-in map (Hz/s).

Implementations

impl TrackingLoopScenario

pub fn loop_config(&self) -> LoopConfig

The resolved loop geometry, with the code allowance defaulted to half the spacing.

pub fn denial_link(&self) -> DenialLink

The jammer link the two denial radii are evaluated on.

pub fn run_json(&self) -> Result<(String, String), String>

Run the scenario, returning the pretty-printed result document and a one-line summary. Deterministic: no random state and no wall-clock read.

Trait Implementations

impl BuiltinKind for TrackingLoopScenario

const KIND: ScenarioKind = ScenarioKind::TrackingLoop

The kind this type answers to.

fn parse(src: &str) -> Result<Self, String>

Parse the scenario source into this type.

fn figure_tiers(&self, _out: &RunOutput) -> Result<Option<Value>, String>

The figure_tiers block for this run, given its finished output; None (the default) when the kind emits none. See the trait docs for the contract.

impl Clone for TrackingLoopScenario

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TrackingLoopScenario

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TrackingLoopScenario

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TrackingLoopScenario

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Scenario for TrackingLoopScenario

fn run(&self) -> Result<RunOutput, KshanaError>

impl Serialize for TrackingLoopScenario

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.