Enum IrsRefinement 

#[repr(u32)]
pub enum IrsRefinement {
    NotSet = 1_100,
    None = 1_101,
    Classical = 1_102,
    ClassicalGmres = 1_103,
    Gmres = 1_104,
    GmresGmres = 1_105,
    GmresNoPcond = 1_106,
    PrecDd = 1_150,
    PrecSs = 1_151,
    PrecSht = 1_152,
}

Indicates which IRS refinement solver to use for a cuSOLVER operation. Empirically, IrsRefinement::Gmres is often the best option.

More details about the refinement process are available in Azzam Haidar, Stanimire Tomov, Jack Dongarra, and Nicholas J. Higham, “Harnessing GPU tensor cores for fast FP16 arithmetic to speed up mixed-precision iterative refinement solvers,” SC ’18.

Variants

NotSet = 1_100

Solver is not set; this value is what is set when creating the params structure. The IRS solver returns an error if this value is used.

None = 1_101

No refinement solver; the IRS solver performs a factorization followed by a solve without any refinement. For example, when used with xgesv, this matches the non-refined solver path with the factorization carried out in the lowest precision. If both the main and lowest precision are PrecisionType::R64F, this is equivalent to solving entirely in f64.

Classical = 1_102

Classical iterative refinement solver. Similar to the value used in LAPACK operations.

ClassicalGmres = 1_103

Classical iterative refinement solver that uses the GMRES (Generalized Minimal Residual) internally to solve the correction equation at each iteration. The classical refinement iteration is the outer iteration, and GMRES is the inner iteration. If the tolerance of the inner GMRES is very low, for example near machine precision, the outer classical refinement iteration performs only one iteration and this option behaves like IrsRefinement::Gmres.

Gmres = 1_104

GMRES (Generalized Minimal Residual) based iterative refinement solver. Recent studies use GMRES as a refinement solver that can outperform classical iterative refinement. Recommended setting based on cuSOLVER experimentation.

GmresGmres = 1_105

GMRES-based iterative refinement solver that uses another GMRES solve internally for the preconditioned system.

GmresNoPcond = 1_106

PrecDd = 1_150

PrecSs = 1_151

PrecSht = 1_152

Trait Implementations

impl Clone for IrsRefinement

fn clone(&self) -> IrsRefinement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IrsRefinement

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

Formats the value using the given formatter.

impl Display for IrsRefinement

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

Formats the value using the given formatter.

impl From<IrsRefinement> for cusolverIRSRefinement_t

fn from(value: IrsRefinement) -> Self

Converts to this type from the input type.

impl From<IrsRefinement> for u32

fn from(enum_value: IrsRefinement) -> Self

Converts to this type from the input type.

impl From<cusolverIRSRefinement_t> for IrsRefinement

fn from(value: cusolverIRSRefinement_t) -> Self

Converts to this type from the input type.

impl Hash for IrsRefinement

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for IrsRefinement

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<u32> for IrsRefinement

type Error = TryFromPrimitiveError<IrsRefinement>

The type returned in the event of a conversion error.

fn try_from(number: u32) -> Result<Self, TryFromPrimitiveError<Self>>

Performs the conversion.

impl TryFromPrimitive for IrsRefinement

const NAME: &'static str = "IrsRefinement"

type Primitive = u32

type Error = TryFromPrimitiveError<IrsRefinement>

fn try_from_primitive( number: Self::Primitive, ) -> Result<Self, TryFromPrimitiveError<Self>>

impl Copy for IrsRefinement

impl Eq for IrsRefinement

impl StructuralPartialEq for IrsRefinement