Struct ShingledForest 

pub struct ShingledForest<const D: usize> { /* private fields */ }

D-dim shingled wrapper over RandomCutForest — scalar-stream input, internal ring buffer of the last D samples.

The ring buffer is stored oldest-to-newest logically but laid out as a circular array internally — constant-time update with no allocation. ShingledForest::current_shingle exposes the logical shingle in read-only form (oldest-first) for diagnostics.

Implementations

impl<const D: usize> ShingledForest<D>

pub const fn shingle_size(&self) -> usize

Shingle size (equals the compile-time D).

pub const fn is_warmed(&self) -> bool

Whether the ring buffer holds a full D-scalar window and the forest has received at least one shingle.

pub fn forest(&self) -> &RandomCutForest<D>

Immutable view of the underlying bare forest — use this to inspect tree state, read metrics, or route through the RandomCutForest::forensic_baseline / attribution helpers on the already-shingled last point.

pub fn forest_mut(&mut self) -> &mut RandomCutForest<D>

Mutable escape hatch — handy for bootstrap replay (RandomCutForest::bootstrap) when the caller has pre-shingled their warm-up corpus.

pub fn current_shingle(&self) -> Option<[f64; D]>

Snapshot the current shingle in logical order (oldest-first). Returns None while the ring is still partially empty.

pub fn update_scalar(&mut self, value: f64) -> RcfResult<bool>

Fold value into the ring buffer; once the ring is full, forward the shingled window to the forest. Returns true when the shingle was submitted to the forest (i.e. the ring was full before the call).

Errors

• RcfError::NaNValue on non-finite value.
• Propagates RandomCutForest::update failures once the shingle is submitted.

pub fn score_scalar(&self, value: f64) -> RcfResult<AnomalyScore>

Score value against the frozen forest without folding it into the ring buffer. The query uses the current shingle with value appended as the newest slot — matches what a subsequent Self::update_scalar would submit.

Errors

• RcfError::NaNValue on non-finite value.
• RcfError::EmptyForest before the ring buffer is full or the forest has not yet received its first update.
• Propagates RandomCutForest::score failures.

pub fn attribution_scalar(&self, value: f64) -> RcfResult<DiVector>

Attribution on the shingle formed by appending value to the current ring. Returns a D-dim DiVector where each dim is a lag index (0 = oldest, D-1 = newest / value).

Errors

Same as Self::score_scalar.

pub fn score_codisp_stateless_scalar( &self, value: f64, ) -> RcfResult<AnomalyScore>

Stateless codisp on the shingle formed with value appended. Non-mutating — preserves the frozen-baseline contract across long streams. Prefer this over the mutating score_codisp path for shingled forensic replay.

Errors

Same as Self::score_scalar.

pub fn reset_ring(&mut self)

Drop the ring buffer and reset the warm-up flag; the underlying forest is not reset — callers who want a full state wipe should rebuild.

Trait Implementations

impl<const D: usize> Debug for ShingledForest<D>

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

Formats the value using the given formatter.