The Belos::SolverManager is a templated virtual base class that defines the basic interface that any solver manager will support. More...

#include <BelosSolverManager.hpp>

Inheritance diagram for Belos::SolverManager< ScalarType, MV, OP >:

[legend]

Constructors/Destructor
	SolverManager ()
	Empty constructor. More...

virtual	~SolverManager ()
	Destructor. More...

virtual Teuchos::RCP < SolverManager< ScalarType, MV, OP > >	clone () const =0
	clone the solver manager. More...

Accessor methods
virtual const LinearProblem < ScalarType, MV, OP > &	getProblem () const =0
	Return a reference to the linear problem being solved by this solver manager. More...

virtual Teuchos::RCP< const Teuchos::ParameterList >	getValidParameters () const =0
	Return the valid parameters for this solver manager. More...

virtual Teuchos::RCP< const Teuchos::ParameterList >	getCurrentParameters () const =0
	Return the current parameters being used for this solver manager. More...

virtual Teuchos::ScalarTraits < ScalarType >::magnitudeType	achievedTol () const
	Tolerance achieved by the last `solve()` invocation. More...

virtual int	getNumIters () const =0
	Get the iteration count for the most recent call to `solve()`. More...

virtual bool	isLOADetected () const =0
	Returns whether a loss of accuracy was detected in the solver. More...

Set methods
virtual void	setProblem (const Teuchos::RCP< LinearProblem< ScalarType, MV, OP > > &problem)=0
	Set the linear problem that needs to be solved. More...

virtual void	setParameters (const Teuchos::RCP< Teuchos::ParameterList > &params)=0
	Set the parameters to use when solving the linear problem. More...

virtual void	setUserConvStatusTest (const Teuchos::RCP< StatusTest< ScalarType, MV, OP > > &, const typename StatusTestCombo< ScalarType, MV, OP >::ComboType &=StatusTestCombo< ScalarType, MV, OP >::SEQ)
	Set user-defined convergence status test. More...

virtual void	setDebugStatusTest (const Teuchos::RCP< StatusTest< ScalarType, MV, OP > > &)
	Set user-defined debug status test. More...

Reset methods
virtual void	reset (const ResetType type)=0
	Reset the solver manager. More...

Solver application methods
virtual ReturnType	solve ()=0
	Iterate until the status test tells us to stop. More...

Additional Inherited Members
Public Member Functions inherited from Teuchos::Describable
DescribableStreamManipulatorState	describe (const Describable &describable, const EVerbosityLevel verbLevel=Describable::verbLevel_default)

std::ostream &	operator<< (std::ostream &os, const DescribableStreamManipulatorState &d)

virtual std::string	description () const

virtual void	describe (FancyOStream &out, const EVerbosityLevel verbLevel=verbLevel_default) const

void	describe (std::ostream &out, const EVerbosityLevel verbLevel=verbLevel_default) const

virtual	~Describable ()

	LabeledObject ()

virtual	~LabeledObject ()

virtual void	setObjectLabel (const std::string &objectLabel)

virtual std::string	getObjectLabel () const

Static Public Attributes inherited from Teuchos::Describable
static const EVerbosityLevel	verbLevel_default

Detailed Description

template<class ScalarType, class MV, class OP>
class Belos::SolverManager< ScalarType, MV, OP >

The Belos::SolverManager is a templated virtual base class that defines the basic interface that any solver manager will support.

Definition at line 39 of file BelosSolverManager.hpp.

Constructor & Destructor Documentation

template<class ScalarType , class MV , class OP >

Belos::SolverManager< ScalarType, MV, OP >::SolverManager ( )

inline

Empty constructor.

Definition at line 47 of file BelosSolverManager.hpp.

template<class ScalarType , class MV , class OP >

virtual Belos::SolverManager< ScalarType, MV, OP >::~SolverManager ( )

inlinevirtual

Destructor.

Definition at line 50 of file BelosSolverManager.hpp.

Member Function Documentation

template<class ScalarType , class MV , class OP >

virtual Teuchos::RCP<SolverManager<ScalarType, MV, OP> > Belos::SolverManager< ScalarType, MV, OP >::clone ( ) const

pure virtual

clone the solver manager.

Implements the DII inversion and injection pattern

template<class ScalarType , class MV , class OP >

virtual const LinearProblem<ScalarType,MV,OP>& Belos::SolverManager< ScalarType, MV, OP >::getProblem ( ) const

pure virtual

Return a reference to the linear problem being solved by this solver manager.

template<class ScalarType , class MV , class OP >

virtual Teuchos::RCP<const Teuchos::ParameterList> Belos::SolverManager< ScalarType, MV, OP >::getValidParameters ( ) const

pure virtual

Return the valid parameters for this solver manager.

template<class ScalarType , class MV , class OP >

virtual Teuchos::RCP<const Teuchos::ParameterList> Belos::SolverManager< ScalarType, MV, OP >::getCurrentParameters ( ) const

pure virtual

Return the current parameters being used for this solver manager.

template<class ScalarType , class MV , class OP >

virtual Teuchos::ScalarTraits<ScalarType>::magnitudeType Belos::SolverManager< ScalarType, MV, OP >::achievedTol ( ) const

inlinevirtual

Tolerance achieved by the last solve() invocation.

This is the maximum over all right-hand sides' achieved convergence tolerances, and is set whether or not the solve actually managed to achieve the desired convergence tolerance.

The default implementation throws std::runtime_error. This is in case the idea of a single convergence tolerance doesn't make sense for some solvers. It also serves as a gradual upgrade path (since this method is a later addition to the SolverManager interface).

Definition at line 81 of file BelosSolverManager.hpp.

template<class ScalarType , class MV , class OP >

virtual int Belos::SolverManager< ScalarType, MV, OP >::getNumIters ( ) const

pure virtual

Get the iteration count for the most recent call to solve().

template<class ScalarType , class MV , class OP >

virtual bool Belos::SolverManager< ScalarType, MV, OP >::isLOADetected ( ) const

pure virtual

Returns whether a loss of accuracy was detected in the solver.

Note: This method is normally applicable to GMRES-type solvers.

template<class ScalarType , class MV , class OP >

virtual void Belos::SolverManager< ScalarType, MV, OP >::setProblem ( const Teuchos::RCP< LinearProblem< ScalarType, MV, OP > > & problem )

pure virtual

Set the linear problem that needs to be solved.

template<class ScalarType , class MV , class OP >

virtual void Belos::SolverManager< ScalarType, MV, OP >::setParameters ( const Teuchos::RCP< Teuchos::ParameterList > & params )

pure virtual

Set the parameters to use when solving the linear problem.

Parameters

params [in/out] List of parameters to use when solving the linear problem. This list will be modified as necessary to include default parameters that need not be provided. If params is null, then this method uses default parameters.

Note: The ParameterList returned by getValidParameters() has all the parameters that the solver understands, possibly including human-readable documentation and validators.

template<class ScalarType , class MV , class OP >

virtual void Belos::SolverManager< ScalarType, MV, OP >::setUserConvStatusTest	(	const Teuchos::RCP< StatusTest< ScalarType, MV, OP > > &	,
		const typename StatusTestCombo< ScalarType, MV, OP >::ComboType &	= `StatusTestCombo<ScalarType,MV,OP>::SEQ`
	)

inlinevirtual

Set user-defined convergence status test.

Reimplemented in Belos::PseudoBlockGmresSolMgr< ScalarType, MV, OP >.

Definition at line 114 of file BelosSolverManager.hpp.

template<class ScalarType , class MV , class OP >

virtual void Belos::SolverManager< ScalarType, MV, OP >::setDebugStatusTest ( const Teuchos::RCP< StatusTest< ScalarType, MV, OP > > & )

inlinevirtual

Set user-defined debug status test.

Reimplemented in Belos::PseudoBlockGmresSolMgr< ScalarType, MV, OP >, and Belos::BlockGmresSolMgr< ScalarType, MV, OP >.

Definition at line 125 of file BelosSolverManager.hpp.

template<class ScalarType , class MV , class OP >

virtual void Belos::SolverManager< ScalarType, MV, OP >::reset ( const ResetType type )

pure virtual

Reset the solver manager.

Reset the solver manager in a way specified by the ResetType parameter. This informs the solver manager that the solver should prepare for the next call to solve by resetting certain elements of the iterative solver strategy.

template<class ScalarType , class MV , class OP >

virtual ReturnType Belos::SolverManager< ScalarType, MV, OP >::solve ( )

pure virtual

Iterate until the status test tells us to stop.

This method performs possibly repeated calls to the underlying linear solver's iterate() routine, until the problem has been solved (as decided by the solver manager via the status test(s)), or the solver manager decides to quit.

Returns

A Belos::ReturnType enum specifying:

Belos::Converged: the linear problem was solved to the specification required by the solver manager.
Belos::Unconverged: the linear problem was not solved to the specification desired by the solver manager.

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

BelosSolverManager.hpp

Constructors/Destructor

Accessor methods

Set methods

Reset methods

Solver application methods

Additional Inherited Members

Detailed Description

template<class ScalarType, class MV, class OP> class Belos::SolverManager< ScalarType, MV, OP >

Constructor & Destructor Documentation

Member Function Documentation

template<class ScalarType, class MV, class OP>
class Belos::SolverManager< ScalarType, MV, OP >