pub struct Binning { /* private fields */ }Expand description
A monotone set of bin edges over a confidence axis (edges.len() == n_bins + 1).
Construct via Binning::equal_mass (protocol default) or Binning::equal_width
(SCE’s published static form). Degenerate duplicate edges are collapsed, so the
realized bin count may be smaller than requested when confidences tie heavily.
Implementations§
Source§impl Binning
impl Binning
Sourcepub fn equal_mass(
confidences: &[f64],
n_bins: usize,
) -> Result<Self, MetricError>
pub fn equal_mass( confidences: &[f64], n_bins: usize, ) -> Result<Self, MetricError>
Equal-mass binning: edges chosen so each bin holds (approximately) n / n_bins
confidences. This is the protocol binning.
§Errors
MetricError::InvalidBinCount if n_bins is zero or exceeds the number of
confidences; MetricError::EmptyInput on an empty slice.
Sourcepub fn equal_width(n_bins: usize) -> Self
pub fn equal_width(n_bins: usize) -> Self
Equal-width binning over [0, 1] — the published static form used by SCE.
Sourcepub fn assign(&self, confidence: f64) -> usize
pub fn assign(&self, confidence: f64) -> usize
Bin index for a confidence value (last bin is closed on both sides).
Sourcepub fn summarize(
&self,
confidences: &[f64],
outcomes: &[bool],
) -> Result<Vec<Bin>, MetricError>
pub fn summarize( &self, confidences: &[f64], outcomes: &[bool], ) -> Result<Vec<Bin>, MetricError>
Populate the bins: mean confidence and mean outcome per non-empty bin.
§Errors
MetricError::LengthMismatch if the slices differ in length;
MetricError::EmptyInput if both are empty.