Enum SolverEvent 

pub enum SolverEvent {
    SolveRequested {
        algorithm: Algorithm,
        matrix_rows: usize,
        matrix_nnz: usize,
        lane: ComputeLane,
    },
    IterationCompleted {
        iteration: usize,
        residual: f64,
        elapsed: Duration,
    },
    SolveConverged {
        algorithm: Algorithm,
        iterations: usize,
        residual: f64,
        wall_time: Duration,
    },
    AlgorithmFallback {
        from: Algorithm,
        to: Algorithm,
        reason: String,
    },
    BudgetExhausted {
        algorithm: Algorithm,
        limit: BudgetLimit,
        elapsed: Duration,
    },
}

Events emitted during a solver invocation.

Events are tagged with #[serde(tag = "type")] so they serialise as { "type": "SolveRequested", ... } for easy ingestion into event stores.

Variants

SolveRequested

A solve request was received and is about to begin.

Fields

algorithm: Algorithm

Algorithm that will be attempted first.

matrix_rows: usize

Matrix dimension (number of rows).

matrix_nnz: usize

Number of non-zeros.

lane: ComputeLane

Compute lane.

IterationCompleted

One iteration of the solver completed.

Fields

iteration: usize

Iteration number (0-indexed).

residual: f64

Current residual norm.

elapsed: Duration

Wall time elapsed since the solve began.

SolveConverged

The solver converged successfully.

Fields

algorithm: Algorithm

Algorithm that produced the result.

iterations: usize

Total iterations executed.

residual: f64

Final residual norm.

wall_time: Duration

Total wall time.

AlgorithmFallback

The solver fell back from one algorithm to another (e.g. Neumann series spectral radius too high, falling back to CG).

Fields

from: Algorithm

Algorithm that failed or was deemed unsuitable.

to: Algorithm

Algorithm that will be tried next.

reason: String

Human-readable reason for the fallback.

BudgetExhausted

The compute budget was exhausted before convergence.

Fields

algorithm: Algorithm

Algorithm that was running when the budget was hit.

limit: BudgetLimit

Which budget limit was hit.

elapsed: Duration

Wall time elapsed.

Trait Implementations

impl Clone for SolverEvent

fn clone(&self) -> SolverEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SolverEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SolverEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SolverEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.