Struct OcclusionModel 

pub struct OcclusionModel {
    pub prob: f64,
    pub span_frames: usize,
}

Temporally-correlated occlusion: an insect is hidden from a camera for contiguous spans of frames — modeling it passing behind another insect or an arena feature.

This differs from ObservationModel::dropout_prob, which drops detections i.i.d. per frame: independent single-frame misses rarely line up into a long gap, whereas occlusion suppresses a whole span at once. Those multi-frame, few-or-zero-observation stretches are what fragment live tracks: the live EKF kills a coasting track that retrack, seeing all data at once, bridges.

Time is tiled into blocks of span_frames; each (camera, insect, block) is independently occluded with probability prob. Adjacent occluded blocks merge, so spans are at least one block and occasionally longer. Default (prob == 0 or span_frames == 0) is never occluded, preserving the perfect-world baseline.

Fields

prob: f64

Probability in [0, 1] that any given block hides the insect from a camera. Default 0 (never occluded).

span_frames: usize

Block length in frames (the occlusion granularity / typical span). Default 0 disables occlusion regardless of prob.

Implementations

impl OcclusionModel

pub fn is_occluded( &self, seed: u64, cam_index: usize, fno: usize, insect_id: u32, ) -> bool

Whether insect_id is occluded from camera cam_index at frame fno, given the scenario seed. Deterministic and constant within a block, so a (config, seed) reproduces the exact occluded spans.

Trait Implementations

impl Clone for OcclusionModel

fn clone(&self) -> OcclusionModel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OcclusionModel

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

Formats the value using the given formatter.

impl Default for OcclusionModel

fn default() -> OcclusionModel

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OcclusionModel

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for OcclusionModel

fn eq(&self, other: &OcclusionModel) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for OcclusionModel

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for OcclusionModel