Spectra
Spectra::GenEigsComplexShiftSolver< Scalar, SelectionRule, OpType > Class Template Reference

#include <GenEigsComplexShiftSolver.h>

Inheritance diagram for Spectra::GenEigsComplexShiftSolver< Scalar, SelectionRule, OpType >:
Spectra::GenEigsSolver< Scalar, SelectionRule, OpType >

Public Member Functions

 GenEigsComplexShiftSolver (OpType *op, int nev, int ncv, const Scalar &sigmar, const Scalar &sigmai)
 
- Public Member Functions inherited from Spectra::GenEigsSolver< Scalar, SelectionRule, OpType >
 GenEigsSolver (OpType *op, int nev, int ncv)
 
virtual ~GenEigsSolver ()
 
void init (const Scalar *init_resid)
 
void init ()
 
int compute (int maxit=1000, Scalar tol=1e-10, int sort_rule=LARGEST_MAGN)
 
int info () const
 
int num_iterations () const
 
int num_operations () const
 
ComplexVector eigenvalues () const
 
ComplexMatrix eigenvectors (int nvec) const
 
ComplexMatrix eigenvectors () const
 

Detailed Description

template<typename Scalar = double, int SelectionRule = LARGEST_MAGN, typename OpType = DenseGenComplexShiftSolve<double>>
class Spectra::GenEigsComplexShiftSolver< Scalar, SelectionRule, OpType >

This class implements the eigen solver for general real matrices with a complex shift value in the shift-and-invert mode. The background knowledge of the shift-and-invert mode can be found in the documentation of the SymEigsShiftSolver class.

Template Parameters
ScalarThe element type of the matrix. Currently supported types are float, double and long double.
SelectionRuleAn enumeration value indicating the selection rule of the shifted-and-inverted eigenvalues. The full list of enumeration values can be found in Enumerations.
OpTypeThe name of the matrix operation class. Users could either use the DenseGenComplexShiftSolve wrapper class, or define their own that impelemnts all the public member functions as in DenseGenComplexShiftSolve.

Definition at line 38 of file GenEigsComplexShiftSolver.h.

Constructor & Destructor Documentation

◆ GenEigsComplexShiftSolver()

template<typename Scalar = double, int SelectionRule = LARGEST_MAGN, typename OpType = DenseGenComplexShiftSolve<double>>
Spectra::GenEigsComplexShiftSolver< Scalar, SelectionRule, OpType >::GenEigsComplexShiftSolver ( OpType *  op,
int  nev,
int  ncv,
const Scalar &  sigmar,
const Scalar &  sigmai 
)
inline

Constructor to create a eigen solver object using the shift-and-invert mode.

Parameters
opPointer to the matrix operation object. This class should implement the complex shift-solve operation of \(A\): calculating \(\mathrm{Re}\{(A-\sigma I)^{-1}v\}\) for any vector \(v\). Users could either create the object from the DenseGenComplexShiftSolve wrapper class, or define their own that impelemnts all the public member functions as in DenseGenComplexShiftSolve.
nevNumber of eigenvalues requested. This should satisfy \(1\le nev \le n-2\), where \(n\) is the size of matrix.
ncvParameter that controls the convergence speed of the algorithm. Typically a larger ncv means faster convergence, but it may also result in greater memory use and more matrix operations in each iteration. This parameter must satisfy \(nev+2 \le ncv \le n\), and is advised to take \(ncv \ge 2\cdot nev + 1\).
sigmarThe real part of the shift.
sigmaiThe imaginary part of the shift.

Definition at line 141 of file GenEigsComplexShiftSolver.h.


The documentation for this class was generated from the following file: