Struct EnsembleView 

pub struct EnsembleView<'a> { /* private fields */ }

Zero-copy view over a packed ensemble binary.

All validation happens in from_bytes. After construction, predictions use get_unchecked for zero-overhead indexing (all bounds have been verified).

Lifetime

The view borrows the input buffer — the buffer must outlive the view.

Implementations

impl<'a> EnsembleView<'a>

pub fn from_bytes(data: &'a [u8]) -> Result<Self, FormatError>

Parse and validate a packed ensemble binary.

Validates:

• Magic bytes match "IRIT"
• Format version is supported
• Buffer is large enough for header + tree table + all nodes
• Every internal node’s child indices are within bounds
• Every internal node’s feature index is < n_features

Errors

Returns FormatError if any validation check fails.

pub fn predict(&self, features: &[f32]) -> f32

Predict a single sample. Zero allocation.

Returns base_prediction + sum(tree_predictions).

Precondition

features.len() must be >= self.n_features(). Passing fewer features than the model expects causes undefined behavior (out-of-bounds read via get_unchecked in the traversal hot path). A debug_assert catches this in debug builds.

pub fn predict_batch(&self, samples: &[&[f32]], out: &mut [f32])

Batch predict. Uses x4 interleaving when samples.len() >= 4.

Panics

Panics if out.len() < samples.len().

Precondition

Every sample must have len() >= self.n_features(). See predict.

pub fn n_trees(&self) -> u16

Number of trees in the ensemble.

pub fn n_features(&self) -> u16

Expected number of input features.

pub fn base_prediction(&self) -> f32

Base prediction value.

pub fn total_nodes(&self) -> usize

Total number of packed nodes across all trees.

Trait Implementations

impl<'a> Clone for EnsembleView<'a>

fn clone(&self) -> EnsembleView<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for EnsembleView<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for EnsembleView<'a>