Struct HalfSpaceTree 

pub struct HalfSpaceTree { /* private fields */ }

A Half-Space Trees ensemble for streaming anomaly detection.

Example

use irithyll::anomaly::hst::{HalfSpaceTree, HSTConfig};

let config = HSTConfig::new(3).n_trees(25).window_size(100);
let mut hst = HalfSpaceTree::new(config);

// Feed normal data to build a reference profile
for i in 0..200 {
    let features = vec![i as f64 * 0.01, 0.5, 0.3];
    hst.update(&features);
}

// Score a point
let result = hst.score(&[0.5, 0.5, 0.3]);
println!("anomaly score: {:.3}, is_anomaly: {}", result.score, result.is_anomaly);

Implementations

impl HalfSpaceTree

pub fn new(config: HSTConfig) -> Self

Create a new Half-Space Tree ensemble.

pub fn with_ranges(config: HSTConfig, ranges: &[(f64, f64)]) -> Self

Create a new ensemble with explicit working ranges per feature.

ranges should contain (min, max) for each feature dimension. This improves partitioning quality when feature ranges are known.

pub fn update(&mut self, features: &[f64])

Feed a sample to the ensemble, updating mass profiles.

When window_size samples have been seen, the latest profile rotates to become the reference and counting restarts.

pub fn score(&self, features: &[f64]) -> AnomalyScore

Score a sample for anomalousness.

Returns an AnomalyScore with a normalized score in [0, 1] (inverted so higher = more anomalous) and an is_anomaly flag.

pub fn score_and_update(&mut self, features: &[f64]) -> AnomalyScore

Combined update + score in one pass.

The sample is scored BEFORE being incorporated into the mass profile, so the score reflects how anomalous it is relative to past data.

pub fn reset(&mut self)

Reset all mass profiles to zero.

pub fn samples_seen(&self) -> u64

Total samples processed.

pub fn windows_completed(&self) -> u64

Number of complete window rotations performed.

pub fn threshold(&self) -> f64

The configured threshold.

Trait Implementations

impl Clone for HalfSpaceTree

fn clone(&self) -> HalfSpaceTree

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HalfSpaceTree

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

Formats the value using the given formatter.