Anasazi
Version of the Day
|
The Anasazi::TraceMinDavidsonSolMgr provides a flexible solver manager over the TraceMinDavidson eigensolver. More...
#include <AnasaziTraceMinDavidsonSolMgr.hpp>
Public Member Functions | |
Constructors | |
TraceMinDavidsonSolMgr (const Teuchos::RCP< Eigenproblem< ScalarType, MV, OP > > &problem, Teuchos::ParameterList &pl) | |
Basic constructor for TraceMinDavidsonSolMgr. More... | |
Public Member Functions inherited from Anasazi::Experimental::TraceMinBaseSolMgr< ScalarType, MV, OP > | |
TraceMinBaseSolMgr (const RCP< Eigenproblem< ScalarType, MV, OP > > &problem, Teuchos::ParameterList &pl) | |
Basic constructor for TraceMinBaseSolMgr. More... | |
virtual | ~TraceMinBaseSolMgr () |
Destructor. More... | |
const Eigenproblem< ScalarType, MV, OP > & | getProblem () const |
Return the eigenvalue problem. More... | |
int | getNumIters () const |
Get the iteration count for the most recent call to solve() . More... | |
Teuchos::Array< RCP < Teuchos::Time > > | getTimers () const |
Return the timers for this object. More... | |
ReturnType | solve () |
This method performs possibly repeated calls to the underlying eigensolver's iterate() routine until the problem has been solved (as decided by the solver manager) or the solver manager decides to quit. More... | |
void | setGlobalStatusTest (const RCP< StatusTest< ScalarType, MV, OP > > &global) |
Set the status test defining global convergence. More... | |
const RCP< StatusTest < ScalarType, MV, OP > > & | getGlobalStatusTest () const |
Get the status test defining global convergence. More... | |
void | setLockingStatusTest (const RCP< StatusTest< ScalarType, MV, OP > > &locking) |
Set the status test defining locking. More... | |
const RCP< StatusTest < ScalarType, MV, OP > > & | getLockingStatusTest () const |
Get the status test defining locking. More... | |
void | setDebugStatusTest (const RCP< StatusTest< ScalarType, MV, OP > > &debug) |
Set the status test for debugging. More... | |
const RCP< StatusTest < ScalarType, MV, OP > > & | getDebugStatusTest () const |
Get the status test for debugging. More... | |
Public Member Functions inherited from Anasazi::SolverManager< ScalarType, MV, OP > | |
SolverManager () | |
Empty constructor. More... | |
virtual | ~SolverManager () |
Destructor. More... | |
The Anasazi::TraceMinDavidsonSolMgr provides a flexible solver manager over the TraceMinDavidson eigensolver.
This solver manager implements a hard-locking mechanism, whereby eigenpairs designated to be locked are moved from the eigensolver and placed in auxilliary storage. The eigensolver is then restarted and continues to iterate, orthogonal to the locked eigenvectors.
The solver manager provides to the solver a StatusTestCombo object constructed as follows:
combo = globaltest OR lockingtest OR debugtest
where
globaltest
terminates computation when global convergence has been detected.globaltest
is a StatusTestResNorm object which tests the 2-norms of the direct residuals relative to the Ritz values.lockingtest
halts TraceMinDavidson::iterate() in order to deflate converged eigenpairs for locking.lockingtest
is a StatusTestResNorm object.debugtest
allows a user to specify additional monitoring of the iteration, encapsulated in a StatusTest objectdebugtest
is ignored.Additionally, the solver manager will terminate and restart solve() when the subspace is full, and it will terminate solve and return after a specified number of restarts.
Much of this behavior is controlled via parameters and options passed to the solver manager. For more information, see TraceMinDavidsonSolMgr().
Definition at line 78 of file AnasaziTraceMinDavidsonSolMgr.hpp.
Anasazi::Experimental::TraceMinDavidsonSolMgr< ScalarType, MV, OP >::TraceMinDavidsonSolMgr | ( | const Teuchos::RCP< Eigenproblem< ScalarType, MV, OP > > & | problem, |
Teuchos::ParameterList & | pl | ||
) |
Basic constructor for TraceMinDavidsonSolMgr.
This constructor accepts the Eigenproblem to be solved in addition to a parameter list of options for the solver manager. Since this class inherits from TraceMinBaseSolMgr, it accepts the same options as TraceMinBaseSolMgr(), with a few additions:
"Use Harmonic Ritz Values"
- a bool
specifying whether to compute the harmonic Ritz values. Unless you're computing interior eigenpairs, this should be false. Default: false"Block Size"
- an int
specifying the block size to be used by the underlying solver. If the eigenvalues are clustered, you may want to use a larger block size to capture the correct multiplicity. Default: 1"Num Blocks"
- an int
specifying the maximum number of blocks in the subspace. After we compute this many blocks, we will restart."Num Restart Blocks"
- an int
specifying how many blocks we keep when restarting. We will extract the most significant blocks from the previous restart and use them to reinitialize TraceMinDavidson. Default: NEV / block size"Maximum Restarts"
- an int
specifying the maximum number of restarts to be performed. Default: 50A special note about Jacobi-Davidson:
Since Jacobi-Davidson is a special case of TraceMin-Davidson, it does not have its own solver class. If you want to run Jacobi-Davidson, all you need to do is set the following options:
"When To Shift"
= "Always"
(which is the default)"How To Choose Shift"
= "Ritz Values"
(not recommended)Choosing the Ritz shifts to be equal to the Ritz values destroys TraceMin-Davidson's guaranteed global convergence, so it is recommended that you consider TraceMin-Davidson (which is identical in every other way) with its default adjusted Ritz shifts instead.
Definition at line 167 of file AnasaziTraceMinDavidsonSolMgr.hpp.