Struct MonitoredRegion 

pub struct MonitoredRegion {
    pub name: String,
    pub range: Range<usize>,
    pub on_threshold: f32,
    pub off_threshold: f32,
    pub weight: f32,
}

A region being monitored for activity with hysteresis thresholds.

Hysteresis

Two thresholds control state transitions to prevent chattering:

• on_threshold: Energy must exceed this to become active
• off_threshold: Energy must drop below this to become quiet

When energy is between the thresholds, the previous state is maintained.

Fields

name: String

Name for identification

range: Range<usize>

Dimension range

on_threshold: f32

Energy threshold to enter active state (higher threshold)

off_threshold: f32

Energy threshold to leave active state (lower threshold)

weight: f32

Weight for convergence calculation

Implementations

impl MonitoredRegion

pub fn new(name: impl Into<String>, range: Range<usize>, threshold: f32) -> Self

Create a new monitored region with automatic hysteresis.

The off_threshold is set to 80% of the on_threshold by default, providing a 20% hysteresis gap to prevent chattering.

pub fn with_hysteresis( name: impl Into<String>, range: Range<usize>, on_threshold: f32, off_threshold: f32, ) -> Self

Create a monitored region with explicit hysteresis thresholds.

Arguments

• on_threshold: Energy must exceed this to become active
• off_threshold: Energy must drop below this to become quiet

Panics

Debug-asserts that off_threshold <= on_threshold

pub fn with_gap(self, gap: f32) -> Self

Set the hysteresis gap as a fraction (0.0 to 1.0).

off_threshold = on_threshold * (1.0 - gap)

pub fn with_weight(self, weight: f32) -> Self

pub fn hysteresis_gap(&self) -> f32

Get the hysteresis gap as a fraction.

Trait Implementations

impl Clone for MonitoredRegion

fn clone(&self) -> MonitoredRegion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MonitoredRegion

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

Formats the value using the given formatter.