Struct DsfTable 

pub struct DsfTable { /* private fields */ }

A validated, Mach-sorted table of up to DSF_MAX_POINTS DsfPoints.

Construct via DsfTable::from_points (bulk, e.g. loading a saved profile) or by starting from an empty table (DsfTable::from_points(Vec::new()), infallible) and growing it with DsfTable::upsert (the dsf CLI verb’s one-observation-at-a-time path in a later task).

Implementations

impl DsfTable

pub fn from_points(points: Vec<DsfPoint>) -> Result<DsfTable, String>

Validate, cap-check, and sort a bulk set of points (e.g. deserialized from a saved profile). Rejects any point failing validation (see DsfPoint bounds) and rejects more than DSF_MAX_POINTS points outright. Does NOT dedupe near-Mach points against each other — that supersede behavior is DsfTable::upsert’s job; a caller assembling points one at a time should use upsert, not construct a Vec with near-duplicates and pass it here.

pub fn upsert(&mut self, point: DsfPoint) -> Result<UpsertOutcome, String>

Insert or supersede a point. A new point within DSF_SUPERSEDE_TOLERANCE_MACH Mach of an existing one replaces it (returning UpsertOutcome::Replaced with the overwritten point); otherwise it is appended (returning UpsertOutcome::Appended), unless the table is already at DSF_MAX_POINTS distinct points, in which case this errors naming the cap.

pub fn factor_at(&self, mach: f64) -> f64

The drop-scale-factor at mach.

• Identity (1.0) at or above DSF_MACH_CEILING, and for an empty table at any Mach — there is nothing to scale by.
• Flat-clamped to the lowest point’s dsf at or below the lowest point’s Mach.
• Piecewise-linear between successive points.
• Piecewise-linear between the highest point and the implicit anchor (DSF_MACH_CEILING, DSF_ANCHOR_VALUE) for Mach between the highest point and the ceiling (this includes single-point tables, where “highest” and “lowest” are the same point).

pub fn points(&self) -> &[DsfPoint]

The table’s points, sorted ascending by Mach.

Trait Implementations

impl Clone for DsfTable

fn clone(&self) -> DsfTable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DsfTable

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

Formats the value using the given formatter.

impl PartialEq for DsfTable

fn eq(&self, other: &DsfTable) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for DsfTable