Enum DmrgSweepError 

#[non_exhaustive]
pub enum DmrgSweepError {
    LengthMismatch {
        mps: usize,
        mpo: usize,
        envs: usize,
    },
    TooFewSites {
        n_sites: usize,
    },
    InvalidParams {
        detail: &'static str,
    },
    MpsNotRightCanonical {
        found: CanonicalForm,
    },
    Step {
        sweep: usize,
        direction: SweepDirection,
        site: usize,
        source: DmrgHeffError,
    },
    Env {
        sweep: usize,
        direction: SweepDirection,
        site: usize,
        source: DmrgEnvError,
    },
    Scale {
        sweep: usize,
        direction: SweepDirection,
        site: usize,
        source: LinalgError,
    },
}

Errors raised by the 2-site DMRG sweep driver sweep_2site.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

LengthMismatch

MPS, MPO, and DmrgEnvs disagree on n_sites.

Fields

mps: usize

n_sites reported by the MPS.

mpo: usize

n_sites reported by the MPO.

envs: usize

n_sites reported by the environments.

TooFewSites

n_sites < 2. 2-site sweeps require at least 2 sites.

Fields

n_sites: usize

The (too-small) site count supplied.

InvalidParams

DmrgSweepParams failed entry-point validation. detail names the constraint that fired.

Fields

detail: &'static str

Names the validation constraint that failed.

MpsNotRightCanonical

MPS canonical form was not Right or Mixed { center: 0 }. Unknown is also rejected — see the module-level docs for the rationale.

Fields

found: CanonicalForm

The canonical form actually found.

Step

The per-step driver (dmrg_2site_step or dmrg_2site_step_block_sparse) returned an error. Source preserved.

Fields

sweep: usize

Sweep cycle where the failure occurred.

direction: SweepDirection

Half-sweep direction at the failure.

site: usize

Left site index at the failure.

source: DmrgHeffError

The underlying per-step error.

Env

DmrgEnvs::advance_left/right returned an error during a post-step env update. Surfaced separately from Step so the caller can distinguish “local solve failed” from “env state became inconsistent”. Defense-in-depth — under the driver’s own advance ordering, this branch should never fire from the public API.

Fields

sweep: usize

Sweep cycle where the failure occurred.

direction: SweepDirection

Half-sweep direction at the failure.

site: usize

Left site index at the failure.

source: DmrgEnvError

The underlying environment-advance error.

Scale

The post-step S-absorb (ariadnetor_linalg::diagonal_scale, which dispatches over layout for both Dense and BlockSparse) failed. Carries the same (sweep, direction, site) breadcrumbs as Step / Env so the caller can pin down where the failure occurred without having to walk the DmrgResult::sweeps history manually.

Fields

sweep: usize

Sweep cycle where the failure occurred.

direction: SweepDirection

Half-sweep direction at the failure.

site: usize

Left site index at the failure.

source: LinalgError

The underlying diagonal-scale (linalg) error.

Trait Implementations

impl Debug for DmrgSweepError

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

Formats the value using the given formatter.

impl Display for DmrgSweepError

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

Formats the value using the given formatter.

impl Error for DmrgSweepError

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<DmrgSweepError> for DmrgError

fn from(source: DmrgSweepError) -> Self

Converts to this type from the input type.