Struct ElevatedPositionTable 

pub struct ElevatedPositionTable { /* private fields */ }

Certified positions of an elevated or banked curve over an intrinsic or a chain plan, in plan distance, read in any order: the plan from an IntrinsicPositionTable or a ChainPositionTable, the height and the pivot in closed form.

Implementations

impl ElevatedPositionTable

pub fn new( curve: &Curve3, error: f64, end: f64, ) -> Option<ElevatedPositionTable>

The table of curve over [0, end], its plan points within about error (IntrinsicPositionTable::new2, ChainPositionTable::new). Some only for an elevated or banked curve whose plan is an intrinsic curve or a chain a ChainPositionTable covers, whose profile is closed form (no intrinsic profile), and for a banked curve whose cant and pivot laws are well formed with no held-rail piece in the cant; None otherwise, for an error or an end that is not finite and positive, or an end past the plan’s length.

pub fn point3(&self, d: f64) -> Option<(DVec3, f64)>

The point at plan distance d and a certified bound on its distance from the exact point: the plan table’s error at d, with the closed-form height (and pivot) exact. None outside [0, end] or where the profile or the pivot has no value.

pub fn point3_on(&self, d: f64, side: SeamSide) -> Option<(DVec3, f64)>

Self::point3 on side of a join of a chain plan (the side makes no difference over an intrinsic plan, or off a join).

pub fn jet3_on(&self, d: f64, side: SeamSide) -> Option<(DVec3, DVec3, DVec3)>

The point, the derivative and the second derivative at plan distance d on side of a join, (c, c', c''): over a chain plan the plan parts (p', p'') from the chain table and the profile’s and the pivot’s in closed form; over an intrinsic plan the curve’s own closed-form derivatives, bit for bit. Self::jet_errors bounds their distances from the exact ones.

pub fn jet_errors(&self) -> [f64; 3]

Certified bounds, uniform over the table, on how far a point, a derivative and a second derivative it returns are from the exact ones: [e0, e1, e2]. The plan’s max_error, max_tangent_error and max_curvature_error over a chain plan (the closed-form profile adds none); [max_error, 0, 0] over an intrinsic plan, whose derivatives are exact closed forms of the heading.

pub fn max_error(&self) -> f64

A certified bound on the error of every point the table returns: the max_error of its plan’s table.

Trait Implementations

impl Clone for ElevatedPositionTable

fn clone(&self) -> ElevatedPositionTable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ElevatedPositionTable

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

Formats the value using the given formatter.