Enum SolverError 

pub enum SolverError {
    Dispatch(String),
    GlobalFailure(String),
    IllConditioned {
        kappa: f64,
    },
    IrlsFailure(String),
    VarproNotSeparable,
    VarproExprEdgesUnsupported,
    VarproDatasetScopingUnsupported,
    MalformedTiedTarget(String),
    TiedTargetNodeMissing(String),
    TiedTargetParamMissing(String),
    UnrecognisedSolver(String),
    UnrecognisedWeightFn(String),
    InvalidEta(f64),
}

Errors originating in the solver layer.

Variants

Dispatch(String)

A free-key or parameter lookup inside the dispatch path failed.

Typically caused by malformed graph input (a free_key that does not match "node_id.param_name" format, or a node/parameter that the compiled graph promised but the spec does not contain).

GlobalFailure(String)

The global optimiser (Differential Evolution) could not produce a finite-cost candidate, e.g. because all population members diverged.

IllConditioned

The post-fit covariance matrix is ill-conditioned (Cholesky failed or the condition number κ was above the safe threshold).

Fields

kappa: f64

The condition number κ = σ_max / σ_min of JᵀJ at the solution.

IrlsFailure(String)

An IRLS weight-update iteration encountered a numerical failure.

VarproNotSeparable

The graph is not separable but VarPro was explicitly requested.

VarproExprEdgesUnsupported

VarPro cannot honour tied parameters (from expr_edges or Parameter.expr).

VarproDatasetScopingUnsupported

VarPro cannot honour per-dataset (dataset_index) node scoping.

MalformedTiedTarget(String)

A tied target had a malformed "node.param" key.

TiedTargetNodeMissing(String)

A tied target referenced a node not present in the compiled graph.

TiedTargetParamMissing(String)

A tied target referenced a parameter not present on the named node.

UnrecognisedSolver(String)

FitOptionsSpec.solver did not match any recognised solver name.

Previously an unrecognised string (e.g. a typo like "lmm" or a wrong-case "Trf") silently fell back to the LM default instead of erroring, which could mask a misconfigured fit with a plausible-looking but unintended result.

UnrecognisedWeightFn(String)

The <weight> suffix of an \"irls:<weight>\" solver string did not match any recognised robust weight function.

Previously an unrecognised suffix (e.g. \"irls:buisquare\") silently fell back to Huber instead of erroring.

InvalidEta(f64)

FitOptionsSpec.eta (the Dogleg / Newton-CG step-acceptance threshold) was not finite and in [0.0, 0.25).

TrustRegionConfig::eta only shrinks the trust-region radius when ρ < 0.25; an eta >= 0.25 opens a band in which a step is rejected without shrinking the radius, so the driver can spin to max_nfev instead of failing cleanly. The driver itself only guards this with a debug_assert!, which compiles out of release builds, so this is the check that actually enforces the bound for callers that reach the Rust core directly (the JSON fit entrypoint, not just the Pydantic FitOptions validator).

Trait Implementations

impl Debug for SolverError

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

Formats the value using the given formatter.

impl Display for SolverError

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

Formats the value using the given formatter.

impl Error for SolverError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<SolverError> for CoreError

Map SolverError to the workspace-wide CoreError.

Symmetric to From<GraphError> for CoreError in the graph crate: the solver produces typed SolverError variants internally; the PyO3 boundary layer (spectrafit-core) and the rest of the workspace consume CoreError, so this conversion lets ? flatten without losing the Display message.

fn from(value: SolverError) -> Self

Converts to this type from the input type.