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_, Scalar sigmar_, 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_,
Scalar  sigmar_,
Scalar  sigmai_ 
)
inline

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

Parameters
op_Pointer 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.
nev_Number of eigenvalues requested. This should satisfy \(1\le nev \le n-2\), where \(n\) is the size of matrix.
ncv_Parameter 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\).
sigmar_The real part of the shift.
sigmai_The imaginary part of the shift.

Definition at line 142 of file GenEigsComplexShiftSolver.h.


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