pub enum EighDriver {
Auto,
DivideAndConquer,
Jacobi,
}Expand description
Algorithm family used by EighOptions.
The family changes speed and rounding, not the decomposition contract, so
gauges and AD rules are unaffected by the choice. A provider may ignore the
selection and run its single eigh kernel. Analogous to SvdDriver and to
scipy.linalg.eigh(..., driver=...).
§Examples
use tenferro_linalg::{EighDriver, EighOptions};
let options = EighOptions::default().driver(EighDriver::Jacobi);
assert_eq!(options.driver, EighDriver::Jacobi);
assert_eq!(EighOptions::default().driver, EighDriver::Auto);Variants§
Auto
The provider’s default policy: the fastest divide-and-conquer kernel it can reach, including a single-launch batched entry point where one exists.
Measured on an A100, the batched entry point is about 100x to 280x faster than the per-matrix loop this default used before. It is a different vendor routine, so a batched result can differ from the per-matrix loop in the last ULPs.
DivideAndConquer
Divide-and-conquer, which is what Self::Auto already selects. Kept
as an explicit spelling of the same choice.
On the CUDA provider this selects cusolverDn<t>syevd.
Jacobi
Jacobi rotations: 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.
On the CUDA provider this selects cusolverDn<t>syevj, heevj for
complex input, and their batched forms.
Trait Implementations§
Source§impl Clone for EighDriver
impl Clone for EighDriver
impl Copy for EighDriver
Source§impl Debug for EighDriver
impl Debug for EighDriver
Source§impl Default for EighDriver
impl Default for EighDriver
impl Eq for EighDriver
Source§impl PartialEq for EighDriver
impl PartialEq for EighDriver
impl StructuralPartialEq for EighDriver
Auto Trait Implementations§
impl Freeze for EighDriver
impl RefUnwindSafe for EighDriver
impl Send for EighDriver
impl Sync for EighDriver
impl Unpin for EighDriver
impl UnsafeUnpin for EighDriver
impl UnwindSafe for EighDriver
Blanket Implementations§
impl<T> Boilerplate for T
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
impl<T, U> Imply<T> for U
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more