Enum BasisError 

pub enum BasisError {
    InvalidDegree(usize),
    InsufficientDegreeForDerivative {
        degree: usize,
        derivative_order: usize,
        minimum_degree: usize,
    },
    InvalidRange(f64, f64),
    DegenerateRange(usize),
    InvalidPenaltyOrder {
        order: usize,
        num_basis: usize,
    },
    InsufficientKnotsForDegree {
        degree: usize,
        required: usize,
        provided: usize,
    },
    InsufficientColumnsForConstraint {
        found: usize,
    },
    ConstraintMatrixRowMismatch {
        basisrows: usize,
        constraintrows: usize,
    },
    WeightsDimensionMismatch {
        expected: usize,
        found: usize,
    },
    LinalgError(FaerLinalgError),
    ConstraintNullspaceCollapsed {
        site: &'static str,
        cross_rank: usize,
        coeff_dim: usize,
        cross_frobenius: f64,
        gram_spectrum: String,
    },
    DegenerateKnots,
    InvalidKnotVector(String),
    SparseCreation(String),
    DimensionMismatch(String),
    IndefinitePenalty {
        context: String,
        min_eigenvalue: f64,
        tolerance: f64,
        guidance: String,
    },
    InvalidInput(String),
    DegenerateAtCollision {
        kernel: &'static str,
        dim: usize,
        m: f64,
        message: &'static str,
    },
    DuchonSmoothnessInsufficient {
        operator: String,
        margin: usize,
        spectral_order: f64,
        dimension: usize,
        nullspace_order: usize,
        power: f64,
        minimum_power: usize,
    },
    Other(String),
}

Re-export of the neutral basis-error contract. #1521: BasisError lives in gam-problem so EstimationError can wrap it (#[from]) without a back-edge; gam-terms re-exports it to preserve gam_terms::basis::BasisError. A comprehensive error type for all operations within the basis module.

Variants

InvalidDegree(usize)

InsufficientDegreeForDerivative

Fields

degree: usize

derivative_order: usize

minimum_degree: usize

InvalidRange(f64, f64)

DegenerateRange(usize)

InvalidPenaltyOrder

Fields

order: usize

num_basis: usize

InsufficientKnotsForDegree

Fields

degree: usize

required: usize

provided: usize

InsufficientColumnsForConstraint

Fields

found: usize

ConstraintMatrixRowMismatch

Fields

basisrows: usize

constraintrows: usize

WeightsDimensionMismatch

Fields

expected: usize

found: usize

LinalgError(FaerLinalgError)

ConstraintNullspaceCollapsed

Fields

site: &'static str

cross_rank: usize

coeff_dim: usize

cross_frobenius: f64

gram_spectrum: String

Pre-formatted constrained-Gram spectrum summary. The structural early-return sites bail at the cross-rank check before the Gram is ever eigendecomposed, so they report not computed rather than a misleading NaN; only the spectral-rank-deficiency site fills in real max/min eigenvalues and tolerance.

DegenerateKnots

InvalidKnotVector(String)

SparseCreation(String)

DimensionMismatch(String)

IndefinitePenalty

Fields

context: String

min_eigenvalue: f64

tolerance: f64

guidance: String

InvalidInput(String)

DegenerateAtCollision

Fields

kernel: &'static str

dim: usize

m: f64

message: &'static str

DuchonSmoothnessInsufficient

A Duchon spline is not smooth enough for an operator a fit path applies to its radial kernel: the kernel’s spectral order 2(p+s) must exceed the covariate dimension by margin for that operator to be finite at the origin.

Fields

operator: String

The operator that needs the smoothness (“pointwise kernel values”, “D2 collocation”, “collision derivative phi^(4)”, …).

margin: usize

The required excess of 2(p+s) over the dimension.

spectral_order: f64

The realised spectral order 2(p+s).

dimension: usize

nullspace_order: usize

The Duchon nullspace order p.

power: f64

The Duchon power s.

minimum_power: usize

The smallest integer power that would admit the operator.

Other(String)

Implementations

impl BasisError

pub fn duchon_smoothness_insufficient( operator: impl Into<String>, margin: usize, dimension: usize, nullspace_order: usize, power: f64, ) -> BasisError

The typed Duchon smoothness refusal for operator, computing the smallest admitting power from the same inequality that refused.

pub fn advice(&self) -> Option<String>

The remediation a user can act on, when the failure has one. This is the single source of the advice every front end prints beside the error; it is keyed on the variant, never on the rendered text (#2470).

Trait Implementations

impl Debug for BasisError

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

Formats the value using the given formatter.

impl Display for BasisError

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

Formats the value using the given formatter.

impl Error for BasisError

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<BasisError> for EstimationError

fn from(source: BasisError) -> EstimationError

Converts to this type from the input type.

impl From<FaerLinalgError> for BasisError

fn from(source: FaerLinalgError) -> BasisError

Converts to this type from the input type.