Anasazi  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
AnasaziEigensolver.hpp
Go to the documentation of this file.
1 // @HEADER
2 // *****************************************************************************
3 // Anasazi: Block Eigensolvers Package
4 //
5 // Copyright 2004 NTESS and the Anasazi contributors.
6 // SPDX-License-Identifier: BSD-3-Clause
7 // *****************************************************************************
8 // @HEADER
9 
10 #ifndef ANASAZI_EIGENSOLVER_HPP
11 #define ANASAZI_EIGENSOLVER_HPP
12 
17 #include "AnasaziConfigDefs.hpp"
18 #include "AnasaziTypes.hpp"
19 
22 
23 #include "AnasaziEigenproblem.hpp"
24 #include "AnasaziSortManager.hpp"
25 #include "AnasaziOutputManager.hpp"
26 #include "AnasaziOrthoManager.hpp"
28 #include "Teuchos_RCP.hpp"
29 #include "Teuchos_Array.hpp"
30 
31 
32 namespace Anasazi {
33 
34 template<class ScalarType, class MV, class OP>
35 class Eigensolver {
36 
37  public:
38 
40 
41 
44 
46 
51  const Teuchos::RCP<SortManager<ScalarType> > &sorter,
52  const Teuchos::RCP<OutputManager<ScalarType> > &printer,
55  Teuchos::ParameterList &params );
56 
58  virtual ~Eigensolver() {};
60 
61 
63 
64 
68  virtual void iterate() = 0;
69 
73  virtual void initialize() = 0;
74 
76 
77 
79 
80 
82  virtual int getNumIters() const = 0;
83 
85  virtual void resetNumIters() = 0;
86 
92 
94  virtual std::vector<Value<ScalarType> > getRitzValues() = 0;
95 
104  virtual std::vector<int> getRitzIndex() = 0;
105 
107 
110  virtual std::vector<typename Teuchos::ScalarTraits<ScalarType>::magnitudeType> getResNorms() = 0;
111 
114  virtual std::vector<typename Teuchos::ScalarTraits<ScalarType>::magnitudeType> getRes2Norms() = 0;
115 
118  virtual std::vector<typename Teuchos::ScalarTraits<ScalarType>::magnitudeType> getRitzRes2Norms() = 0;
119 
121  virtual int getCurSubspaceDim() const = 0;
122 
124  virtual int getMaxSubspaceDim() const = 0;
125 
127 
128 
129 
131 
132 
135 
138 
140  virtual const Eigenproblem<ScalarType,MV,OP>& getProblem() const = 0;
141 
143  virtual int getBlockSize() const = 0;
144 
146  virtual void setBlockSize(int blockSize) = 0;
147 
149  virtual void setAuxVecs(const Teuchos::Array<Teuchos::RCP<const MV> > &auxvecs) = 0;
150 
153 
155  virtual bool isInitialized() const = 0;
156 
158 
160 
161 
163  virtual void currentStatus(std::ostream &os) = 0;
164 
166 
167 };
168 
169 } // end Anasazi namespace
170 
171 #endif /* ANASAZI_EIGENSOLVER_HPP */
virtual std::vector< typename Teuchos::ScalarTraits< ScalarType >::magnitudeType > getResNorms()=0
Get the current residual norms.
virtual bool isInitialized() const =0
States whether the solver has been initialized or not.
virtual void initialize()=0
Initialize the solver with the initial vectors from the eigenproblem or random data.
virtual int getBlockSize() const =0
Get the blocksize to be used by the iterative solver in solving this eigenproblem.
virtual Teuchos::Array< Teuchos::RCP< const MV > > getAuxVecs() const =0
Get the auxiliary vectors for the solver.
virtual void iterate()=0
This method performs eigensolvers iterations until the status test indicates the need to stop or an e...
virtual std::vector< Value< ScalarType > > getRitzValues()=0
Get the Ritz values from the previous iteration.
This class defines the interface required by an eigensolver and status test class to compute solution...
virtual void currentStatus(std::ostream &os)=0
This method requests that the solver print out its current status to screen.
virtual int getCurSubspaceDim() const =0
Get the dimension of the search subspace used to generate the current eigenvectors and eigenvalues...
virtual void setStatusTest(Teuchos::RCP< StatusTest< ScalarType, MV, OP > > test)=0
Set a new StatusTest for the solver.
virtual Teuchos::RCP< StatusTest< ScalarType, MV, OP > > getStatusTest() const =0
Get the current StatusTest used by the solver.
virtual void setBlockSize(int blockSize)=0
Set the blocksize to be used by the iterative solver in solving this eigenproblem.
virtual void resetNumIters()=0
Reset the iteration count.
Forward declaration of pure virtual base class Anasazi::StatusTest.
Forward declaration of the virtual base class Anasazi::Eigensolver.
Abstract class definition for Anasazi Output Managers.
Abstract base class which defines the interface required by an eigensolver and status test class to c...
Output managers remove the need for the eigensolver to know any information about the required output...
Templated virtual class for providing orthogonalization/orthonormalization methods.
virtual std::vector< typename Teuchos::ScalarTraits< ScalarType >::magnitudeType > getRitzRes2Norms()=0
virtual ~Eigensolver()
Destructor.
Anasazi header file which uses auto-configuration information to include necessary C++ headers...
Virtual base class which defines the interface between an eigensolver and a class whose job is the so...
virtual std::vector< typename Teuchos::ScalarTraits< ScalarType >::magnitudeType > getRes2Norms()=0
virtual Teuchos::RCP< const MV > getRitzVectors()=0
Get the Ritz vectors from the previous iteration. These are indexed using getRitzIndex().
virtual std::vector< int > getRitzIndex()=0
Get the index used for indexing the compressed storage used for Ritz vectors for real, non-Hermitian problems.
virtual void setAuxVecs(const Teuchos::Array< Teuchos::RCP< const MV > > &auxvecs)=0
Set the auxiliary vectors for the solver.
virtual const Eigenproblem< ScalarType, MV, OP > & getProblem() const =0
Get a constant reference to the eigenvalue problem.
Types and exceptions used within Anasazi solvers and interfaces.
Eigensolver()
Default Constructor.
Anasazi&#39;s templated virtual class for providing routines for orthogonalization and orthonormalization...
virtual int getMaxSubspaceDim() const =0
Get the maximum dimension allocated for the search subspace.
Anasazi&#39;s templated pure virtual class for managing the sorting of approximate eigenvalues computed b...
Common interface of stopping criteria for Anasazi&#39;s solvers.
virtual int getNumIters() const =0
Get the current iteration count.
The Eigensolver is a templated virtual base class that defines the basic interface that any eigensolv...