Enum EighDriver 

pub enum EighDriver {
    Auto,
    Syevd,
    Syevj,
}

cuSOLVER Hermitian eigensolver selection used by EighOptions on the CUDA backend.

The driver changes speed and rounding, not the decomposition contract, so gauges and AD rules are unaffected. CPU providers have a single eigh kernel and ignore it. Analogous to SvdDriver and to scipy.linalg.eigh(..., driver=...).

Examples

use tenferro_linalg::{EighDriver, EighOptions};

let options = EighOptions::default().driver(EighDriver::Syevj);
assert_eq!(options.driver, EighDriver::Syevj);
assert_eq!(EighOptions::default().driver, EighDriver::Auto);

Variants

Auto

The backend’s default policy: the fastest divide-and-conquer routine available. On CUDA a single matrix uses syevd/heevd and a batch uses cusolverDnXsyevBatched, which solves the whole batch in one launch at the same accuracy. On an A100 that is about 100x to 280x faster than the per-matrix loop this default used before.

The batched routine is a different cuSOLVER entry point, so batched results can differ from the per-matrix loop in the last ULPs.

Syevd

cuSOLVER’s divide-and-conquer driver, which is what Self::Auto already selects. Kept as an explicit spelling of the same choice.

Syevj

cuSOLVER’s Jacobi driver (cusolverDn<t>syevj, heevj for complex input, and their batched forms).

Worth asking for only on batches of small matrices: measured on an A100 it is slightly ahead of the default up to about order 32 and loses from there, by about 4x at order 128 and far more on wide spectra, where it is also the less accurate of the two.

Trait Implementations

impl Clone for EighDriver

fn clone(&self) -> EighDriver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EighDriver

impl Debug for EighDriver

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

Formats the value using the given formatter.

impl Default for EighDriver

fn default() -> EighDriver

Returns the “default value” for a type.

impl Eq for EighDriver

impl PartialEq for EighDriver

fn eq(&self, other: &EighDriver) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for EighDriver