espectre::StartupThresholdCalibrator Class Reference

Startup threshold calibrator with a motion-first primary path and an internal quiet-first fallback. More...

#include <threshold.h>

Public Member Functions
void	begin (uint16_t target_packets, bool gate_enabled)
void	observe (bool detector_ready, float motion_metric, uint16_t packet_weight=1U)
	Consume one evaluated detector step representing one or more packets.
bool	is_complete () const
	True once motion-first succeeds early or the startup budget is spent.
bool	is_successful () const
bool	gate_accepted () const
uint32_t	packet_count () const
uint16_t	target_packets () const
uint32_t	ready_packet_count () const
float	threshold_metric () const
	Metric the threshold formula (x factor) is applied to.
const char *	statistic_name () const
	Statistic name for threshold logging.
const char *	phase_label () const

Detailed Description

Startup threshold calibrator with a motion-first primary path and an internal quiet-first fallback.

The fallback keeps the existing gated ring of chunk maxima, but completion never exceeds the configured budget.

Definition at line 88 of file threshold.h.

Member Function Documentation

begin()

void espectre::StartupThresholdCalibrator::begin ( uint16_t target_packets, bool gate_enabled )

inline

Definition at line 90 of file threshold.h.

observe()

void espectre::StartupThresholdCalibrator::observe ( bool detector_ready, float motion_metric, uint16_t packet_weight = 1U )

inline

Consume one evaluated detector step representing one or more packets.

Parameters

detector_ready	Whether the detector metric window is full
motion_metric	Current detector motion metric
packet_weight	Number of processed packets represented by the metric

Definition at line 128 of file threshold.h.

is_complete()

bool espectre::StartupThresholdCalibrator::is_complete ( ) const

inline

True once motion-first succeeds early or the startup budget is spent.

Definition at line 162 of file threshold.h.

is_successful()

bool espectre::StartupThresholdCalibrator::is_successful ( ) const

inline

Definition at line 166 of file threshold.h.

gate_accepted()

bool espectre::StartupThresholdCalibrator::gate_accepted ( ) const

inline

Definition at line 167 of file threshold.h.

packet_count()

uint32_t espectre::StartupThresholdCalibrator::packet_count ( ) const

inline

Definition at line 168 of file threshold.h.

target_packets()

uint16_t espectre::StartupThresholdCalibrator::target_packets ( ) const

inline

Definition at line 169 of file threshold.h.

ready_packet_count()

uint32_t espectre::StartupThresholdCalibrator::ready_packet_count ( ) const

inline

Definition at line 170 of file threshold.h.

threshold_metric()

float espectre::StartupThresholdCalibrator::threshold_metric ( ) const

inline

Metric the threshold formula (x factor) is applied to.

Definition at line 173 of file threshold.h.

statistic_name()

const char * espectre::StartupThresholdCalibrator::statistic_name ( ) const

inline

Statistic name for threshold logging.

Definition at line 200 of file threshold.h.

phase_label()

const char * espectre::StartupThresholdCalibrator::phase_label ( ) const

inline

Definition at line 219 of file threshold.h.

---

The documentation for this class was generated from the following file:

• src/cpp/core/threshold.h