Struct QuadratureSolution 

pub struct QuadratureSolution { /* private fields */ }

The outcome of a single quadrature lane.

The fields are private on purpose, on the same reasoning as OdeLaneSolution: Self::value returns Option<f64> and hands back Some only for a lane that ran to completion, while the raw number is behind the deliberately-named Self::last_value.

Copy, so it can be read out of a QuadratureBatch without cloning.

Units

Self::value, Self::last_value and Self::error_estimate are in the integral’s units (integrand times abscissa); Self::evaluations is a dimensionless count.

Implementations

impl QuadratureSolution

pub fn value(&self) -> Option<f64>

The integral, if this lane ran to completion.

None for every failure status. This is the accessor to reach for; the Option is the point.

pub fn last_value(&self) -> f64

The last value the rule accumulated, complete or not.

The integral only when Self::status is QuadratureStatus::Evaluated. For QuadratureStatus::ToleranceNotMet this is the best estimate the adaptive lane reached and is offered for diagnosis — for deciding whether the lane was close or wildly off. For the other two statuses it is NaN, because there is no honest number to report.

pub fn error_estimate(&self) -> f64

Estimated absolute error, in the integral’s units.

Meaningful only for adaptive_quadrature_batch, where it is the summed Richardson estimate |S_2 - S_1| / 15 over the accepted sub-intervals. NaN for every fixed QuadratureRule, because a fixed rule has no error estimate to give and returning 0.0 would be a falsehood.

pub fn evaluations(&self) -> u32

Integrand evaluations this lane performed, dimensionless.

Fixed and predictable for a QuadratureRule; data-dependent for the adaptive path, where it is the honest measure of how hard the integrand was and the source of the load imbalance work-stealing exists to absorb.

pub fn status(&self) -> QuadratureStatus

How this lane ended.

pub fn evaluated(&self) -> bool

Whether this lane produced a usable value.

Trait Implementations

impl Clone for QuadratureSolution

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for QuadratureSolution

impl Debug for QuadratureSolution

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

Formats the value using the given formatter.

impl PartialEq for QuadratureSolution

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for QuadratureSolution