Struct Solution

pub struct Solution<T, Y, D>
where
    T: Real,
    Y: State<T>,
    D: CallBackData,
{
    pub t: Vec<T>,
    pub y: Vec<Y>,
    pub status: Status<T, Y, D>,
    pub evals: Evals,
    pub steps: Steps,
    pub timer: Timer<T>,
}

The result produced by differential equation solvers.

Fields

• y - Outputted dependent variable points.
• t - Outputted independent variable points.
• status - Status of the solver.
• evals - Number of function evaluations.
• steps - Number of steps.
• timer - Timer for tracking solution time.

Fields

t: Vec<T>

Outputted independent variable points.

y: Vec<Y>

Outputted dependent variable points.

status: Status<T, Y, D>

Status of the solver.

evals: Evals

Number of function, Jacobian, and related evaluations.

steps: Steps

Number of steps taken during the solution.

timer: Timer<T>

Timer tracking wall-clock time. Running during solving, Completed after finalization.

Implementations

impl<T, Y, D> Solution<T, Y, D>

where T: Real, Y: State<T>, D: CallBackData,

pub fn new() -> Self

Creates a new Solution object.

impl<T, Y, D> Solution<T, Y, D>

where T: Real, Y: State<T>, D: CallBackData,

pub fn push(&mut self, t: T, y: Y)

Push a new (t, y) point into the solution.

Arguments

• t - The time point.
• y - The state vector.

pub fn pop(&mut self) -> Option<(T, Y)>

Pop the last (t, y) point from the solution.

Returns

• Option<(T, SMatrix<T, R, C>)> - The last point in the solution.

pub fn truncate(&mut self, index: usize)

Truncates the solution’s (t, y) points to the given index.

Arguments

• index - The index to truncate to.

impl<T, Y, D> Solution<T, Y, D>

where T: Real, Y: State<T>, D: CallBackData,

pub fn into_tuple(self) -> (Vec<T>, Vec<Y>)

Consume the solution into (t, y) vectors.

Status, evaluation counters, steps, and timers are discarded.

Returns

• (Vec<T>, Vec<Y) - Tuple of time and state vectors.

pub fn last(&self) -> Result<(&T, &Y), Box<dyn Error>>

Return the last accepted step (t, y).

Returns

• Result<(T, Y), Box<dyn std::error::Error>> - Result of time and state vector.

pub fn iter(&self) -> Zip<Iter<'_, T>, Iter<'_, Y>>

Returns an iterator over the solution.

Returns

• std::iter::Zip<std::slice::Iter<'_, T>, std::slice::Iter<'_, Y>> - An iterator yielding (t, y) tuples.

pub fn to_csv(&self, filename: &str) -> Result<(), Box<dyn Error>>

Write the solution to CSV using only the standard library.

Note the columns will be named t, y0, y1, …, yN.

Arguments

• filename - Name of the file to save the solution.

Returns

• Result<(), Box<dyn std::error::Error>> - Result of writing the file.

Trait Implementations

impl<T, Y, D> Clone for Solution<T, Y, D>

where T: Real + Clone, Y: State<T> + Clone, D: CallBackData + Clone,

fn clone(&self) -> Solution<T, Y, D>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T, Y, D> Debug for Solution<T, Y, D>

where T: Real + Debug, Y: State<T> + Debug, D: CallBackData + Debug,

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

Formats the value using the given formatter.

impl<T, Y, D> Default for Solution<T, Y, D>

where T: Real, Y: State<T>, D: CallBackData,

fn default() -> Self

Returns the “default value” for a type.