Struct CurveProvenance 

pub struct CurveProvenance {
    entries: Vec<ProvenanceEntry>,
    jacobian: Vec<Vec<f64>>,
    jacobian_engine: JacobianEngine,
}

The ladder a curve was calibrated from: what it reprices, and how its pillars move when those quotes do.

Held behind an Arc once pinned, so a curve serving two roles shares one ladder rather than two copies of it — which is also what makes the two roles’ risk meet in the same par column rather than in two disjoint sets.

Fields

entries: Vec<ProvenanceEntry>

One entry per rung, in solve order — the same order as the curve’s flat parameter vector, and the same length.

jacobian: Vec<Vec<f64>>

∂z/∂q, row-major: jacobian[pillar][rung] is how far pillar pillar’s parameter moves per unit move in rung rung’s quote.

Rows are in the curve’s flat parameter order, so a risk entry’s node_index is the row index. Columns are in rung order, and are identified by this ladder together with their position — not by a curve role, so a curve pinned under two roles presents one column set to both.

Always square, with one row and one column per entry — the constructors admit no other shape.

jacobian_engine: JacobianEngine

Which engine built jacobian. Lanes for a ladder stood up from parts, which carries no record of how its matrix was made.

Implementations

impl CurveProvenance

pub fn from_parts( entries: Vec<ProvenanceEntry>, jacobian: Vec<Vec<f64>>, ) -> Result<Self, ProvenanceShape>

A ladder from its parts, both required.

The calibration builds its own; this is the seam for a caller standing one up from elsewhere. Both parts are taken together because a ladder carrying rungs but no ∂z/∂q is a half-thing: it would satisfy the rung-count check at pinning and then have no row for any pillar to land on, which is a failure discovered at the far end of the system from the mistake.

Errors

ProvenanceShape unless jacobian is square with one row and one column per entry.

pub fn jacobian(&self) -> &[Vec<f64>]

∂z/∂q, row-major and indexed [pillar][rung].

pub fn jacobian_engine(&self) -> JacobianEngine

Which engine built jacobian.

pub fn with_engine(self, engine: JacobianEngine) -> Self

This ladder, recorded as built by engine.

pub fn entries(&self) -> &[ProvenanceEntry]

The ladder’s rungs, in solve order.

pub fn len(&self) -> usize

How many rungs — equally, how many pillars the curve carries.

pub fn is_empty(&self) -> bool

Whether the ladder is empty. A calibration never produces one; the method exists because a length accessor without it is a clippy lint.

Trait Implementations

impl Clone for CurveProvenance

fn clone(&self) -> CurveProvenance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CurveProvenance

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

Formats the value using the given formatter.

impl PartialEq for CurveProvenance

fn eq(&self, other: &CurveProvenance) -> 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 CurveProvenance