mod calibration

module calibration

Immutable calibration artifact for the fixed census radius.

Variables

const MINIMUM_CENSUS_CALIBRATION_PAIRS: usize

Minimum sample count needed to resolve the 0.99 nearest-rank tail.

Functions

fn calibrate_census_radius(signature_digest: SignatureDigest, descriptor_schema: DescriptorSignature, mut pairs: Vec<CalibrationPair>) -> Result<CensusCalibration, CalibrationError>

Build the production 0.99 nearest-rank calibration artifact.

Enums

enum CalibrationError

Input failure that prevents creation of a calibration artifact.

InsufficientSamples

The development pool is too small to resolve the requested tail.

minimum: usize

Required number of same-minimum pairs.

actual: usize

Supplied number of pairs.

SignatureMismatch

A pair belongs to a different system identity.

pair_id: String

Stable identity of the rejected pair.

MinimumMismatch

The two configurations did not quench to the same exact minimum.

pair_id: String

Stable identity of the rejected pair.

NonFiniteDistance

A pair has a NaN or infinite descriptor distance.

pair_id: String

Stable identity of the rejected pair.

NegativeDistance

A pair has an impossible negative descriptor distance.

pair_id: String

Stable identity of the rejected pair.

DuplicatePairId

Stable pair identities must be unique within one artifact.

pair_id: String

Repeated pair identity.

enum EmpiricalQuantileMethod

Versioned empirical-quantile convention used by a calibration artifact.

NearestRankV1

Sorted rank ceil(q n), with ranks numbered from one.

Structs and Unions

struct CalibrationPair

Descriptor-distance evidence from two perturbations of one exact minimum.

pair_id: String

Stable identity of this pair in the archived development pool.

left_configuration_id: String

Stable identity of the first perturbed configuration.

right_configuration_id: String

Stable identity of the second perturbed configuration.

left_minimum_id: String

Exact quenched-minimum identity for the first configuration.

right_minimum_id: String

Exact quenched-minimum identity for the second configuration.

signature_digest: SignatureDigest

System signature under which both structures were evaluated.

distance: f64

Descriptor distance between the quenched configurations.

struct CensusCalibration

Fixed census-radius artifact and its complete development evidence.

Implementations

impl CensusCalibration

Functions

fn census_radius(&self) -> f64

Calibrated fixed census radius.

fn descriptor_schema(&self) -> &DescriptorSignature

Descriptor schema used to calculate every distance.

fn pairs(&self) -> &[CalibrationPair]

Raw evidence in canonical pair-identity order.

fn quantile(&self) -> f64

Requested empirical quantile.

fn quantile_method(&self) -> EmpiricalQuantileMethod

Versioned quantile convention.

fn sample_count(&self) -> usize

Number of raw development pairs.

fn signature_digest(&self) -> SignatureDigest

System identity shared by every raw pair.