Struct LagMap 

pub struct LagMap { /* private fields */ }

Lag-alignment cache for a regular series of length series_len.

For max_lag = τ_max under ReferencePointPolicy::SeriesOrigin, effective samples are times t = τ_max .. series_len-1 (n = series_len - τ_max). Sample i at lag τ reads raw row base_t + i - τ.

Implementations

impl LagMap

pub fn new(series_len: usize, max_lag: u32) -> Result<Self, DataError>

Build a lag map with the default series-origin reference policy.

Errors

Empty series, or max_lag >= series_len.

pub fn with_reference( series_len: usize, max_lag: u32, reference: ReferencePointPolicy, ) -> Result<Self, DataError>

Build a lag map under an explicit reference-point policy.

Errors

Empty series, invalid lag, or origin out of range.

pub const fn series_len(&self) -> usize

Series length.

pub const fn max_lag(&self) -> u32

Configured maximum lag.

pub const fn n_effective(&self) -> usize

Number of aligned samples.

pub const fn reference(&self) -> ReferencePointPolicy

Reference-point policy used to build this map.

pub fn row_index(&self, lag: Lag, sample_i: usize) -> usize

Raw row index for sample i at the given lag.

Panics

Panics if i >= n_effective or lag.raw() > max_lag.

pub fn fill_row_indexes( &self, lag: Lag, out: &mut [usize], ) -> Result<(), DataError>

Fill out with raw row indexes for lag (out.len() must equal n_effective).

Errors

Length mismatch or lag exceeding max_lag.

Trait Implementations

impl Clone for LagMap

fn clone(&self) -> LagMap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LagMap

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

Formats the value using the given formatter.

impl Eq for LagMap

impl PartialEq for LagMap

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LagMap