Enum RcfError 

#[non_exhaustive]
pub enum RcfError {
    DimensionMismatch {
        expected: usize,
        got: usize,
    },
    InvalidConfig(Box<str>),
    EmptyForest,
    EmptyBoundingBox,
    NaNValue,
    OutOfBounds {
        index: usize,
        len: usize,
    },
    SerializationFailed(String),
    DeserializationFailed(String),
    IncompatibleVersion {
        found: u32,
        expected: u32,
    },
}

Errors produced by anomstream-core.

Variants are stable across 0.x patch releases — adding a new variant is a minor-version change.

Examples

use anomstream_core::{ForestBuilder, RcfError};

let err = ForestBuilder::<4>::new().num_trees(10).build().unwrap_err();
assert!(matches!(err, RcfError::InvalidConfig(_)));

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

DimensionMismatch

A point with the wrong dimensionality was supplied.

Fields

expected: usize

Dimensionality the forest was configured with.

got: usize

Dimensionality of the offending input.

InvalidConfig(Box<str>)

A configuration value falls outside the AWS SageMaker spec bounds enforced by ForestBuilder. The message payload is Box<str> rather than String so the variant fits in 16 bytes on 64-bit targets (vs 24 for String) — matters when RcfError propagates through hot-path return values.

EmptyForest

An operation that requires a non-empty forest was attempted on an empty one (e.g. scoring before any update call).

EmptyBoundingBox

A bounding box operation was requested on an empty box.

NaNValue

A floating-point input contained NaN, which would break the total ordering required by every algorithm in the crate.

OutOfBounds

An indexed access fell outside the live range.

Fields

index: usize

Index that was attempted.

len: usize

Current length of the underlying collection.

SerializationFailed(String)

Persistence: serialising the forest failed.

Left as String (not Box<str>) because every emission site formats a fresh heap-allocated message from an upstream serde / postcard error — the extra 8 bytes per variant vs Box<str> would cost a round-trip through Box::from(String) on an already-cold path.

DeserializationFailed(String)

Persistence: deserialising the forest failed (truncated bytes, malformed JSON, version-skew payload, etc). See Self::SerializationFailed for the String-vs-Box<str> rationale.

IncompatibleVersion

Persistence: the encoded version prefix does not match the running library’s expected version.

Fields

found: u32

Version embedded in the loaded payload.

expected: u32

Version the running library understands.

Trait Implementations

impl Debug for RcfError

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

Formats the value using the given formatter.

impl Display for RcfError

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

Formats the value using the given formatter.

impl Error for RcfError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.