Struct CalibrationObjective 

pub struct CalibrationObjective {
    pub metric: ObjectiveMetric,
    pub target: Option<f64>,
}

One iterable target: which scalar drives the loop + optional convergence threshold.

Fields

metric: ObjectiveMetric

Which scalar drives the loop.

target: Option<f64>

Optional convergence target — stop when the multi-seed mean loss is ≤ this. None (default) lets the loop run to max_iterations / patience exhaustion.

Implementations

impl CalibrationObjective

pub fn bf_composite() -> Self

Default — minimise the BF composite mean, no explicit target.

pub fn with_metric(self, m: ObjectiveMetric) -> Self

Pick a specific metric. Identical to constructing the struct directly; provided as a fluent builder for callers that read nicer with a chained form.

pub fn with_target(self, t: f64) -> Self

Set a convergence target. Stops the loop when E_seed[L] ≤ t.

pub fn evaluate(&self, report: &BehavioralFidelityReport) -> Option<f64>

Compute the scalar loss for one report.

All three scalars are always present in the BehavioralFidelityReport (the v5.x writer fills them via #[serde(default)]-zero on older fixtures), so this never returns None. The return is Option to allow a future per-submetric variant to signal a missing-path error without a breaking signature change.

pub fn aggregate( &self, reports: &[BehavioralFidelityReport], ) -> Option<(f64, f64)>

Aggregate multiple BF reports into a single (mean, std) pair — the multi-seed harness the C3 loop relies on for noise-floor rejection (T3 methodology: single-shard composite CV ≈ 25 %, so a step must beat the prior best by > ~σ to be credited).

Returns None only when reports is empty.

Trait Implementations

impl Clone for CalibrationObjective

fn clone(&self) -> CalibrationObjective

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CalibrationObjective

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

Formats the value using the given formatter.

impl Default for CalibrationObjective

fn default() -> CalibrationObjective

Returns the “default value” for a type.