GEOSX
Public Types | Public Member Functions | List of all members
geosx::TrilinosPreconditioner Class Referencefinal

Wrapper around Trilinos-based preconditioners. More...

#include <TrilinosPreconditioner.hpp>

Inheritance diagram for geosx::TrilinosPreconditioner:
Inheritance graph
[legend]

Public Types

using Base = PreconditionerBase< TrilinosInterface >
 Alias for base type.
 
using Vector = typename Base::Vector
 Alias for vector type.
 
using Matrix = typename Base::Matrix
 Alias for matrix type.
 
- Public Types inherited from geosx::PreconditionerBase< TrilinosInterface >
using Base = LinearOperator< typename TrilinosInterface ::ParallelVector >
 Alias for base type.
 
using Vector = typename Base::Vector
 Alias for vector type.
 
using Matrix = typename TrilinosInterface ::ParallelMatrix
 Alias for matrix type.
 
- Public Types inherited from geosx::LinearOperator< TrilinosInterface ::ParallelVector >
using Vector = TrilinosInterface ::ParallelVector
 Alias for template parameter.
 

Public Member Functions

 TrilinosPreconditioner (LinearSolverParameters params)
 Constructor. More...
 
 TrilinosPreconditioner (LinearSolverParameters params, array1d< Vector > const &nearNullKernel)
 Constructor. More...
 
virtual ~TrilinosPreconditioner () override
 Destructor.
 
virtual void compute (Matrix const &mat) override
 Compute the preconditioner from a matrix. More...
 
virtual void apply (Vector const &src, Vector &dst) const override
 Apply operator to a vector. More...
 
virtual void clear () override
 Clean up the preconditioner setup. More...
 
Epetra_Operator const & unwrapped () const
 Access the underlying Epetra preconditioning operator. More...
 
Epetra_Operator & unwrapped ()
 Access the underlying Epetra preconditioning operator. More...
 
- Public Member Functions inherited from geosx::PreconditionerBase< TrilinosInterface >
virtual void compute (Matrix const &mat)
 Compute the preconditioner from a matrix. More...
 
virtual void compute (Matrix const &mat, DofManager const &dofManager)
 Compute the preconditioner from a matrix. More...
 
virtual globalIndex numGlobalRows () const override
 Get the number of global rows. More...
 
virtual globalIndex numGlobalCols () const override
 Get the number of global columns. More...
 
bool ready () const
 Chech if preconditioner is ready to use. More...
 
Matrix const & matrix () const
 Access the matrix the preconditioner was computed from. More...
 
virtual bool hasPreconditionerMatrix () const
 Check whether the preconditioner is available in matrix (explicit) form. More...
 
virtual Matrix const & preconditionerMatrix () const
 Access the preconditioner in matrix form (whenever available). It must be overridden by the specific preconditioner. More...
 
- Public Member Functions inherited from geosx::LinearOperator< TrilinosInterface ::ParallelVector >
 LinearOperator ()=default
 Constructor.
 
virtual ~LinearOperator ()=default
 Destructor.
 
virtual void apply (Vector const &src, Vector &dst) const=0
 Apply operator to a vector. More...
 
virtual void residual (Vector const &x, Vector const &b, Vector &r) const
 Compute residual r = Ax - b. More...
 

Detailed Description

Wrapper around Trilinos-based preconditioners.

Definition at line 41 of file TrilinosPreconditioner.hpp.

Constructor & Destructor Documentation

◆ TrilinosPreconditioner() [1/2]

geosx::TrilinosPreconditioner::TrilinosPreconditioner ( LinearSolverParameters  params)
explicit

Constructor.

Parameters
paramspreconditioner parameters

◆ TrilinosPreconditioner() [2/2]

geosx::TrilinosPreconditioner::TrilinosPreconditioner ( LinearSolverParameters  params,
array1d< Vector > const &  nearNullKernel 
)

Constructor.

Parameters
paramspreconditioner parameters
nearNullKernelthe user-provided near null kernel

Member Function Documentation

◆ apply()

virtual void geosx::TrilinosPreconditioner::apply ( Vector const &  src,
Vector dst 
) const
overridevirtual

Apply operator to a vector.

Parameters
srcInput vector (x).
dstOutput vector (b).
Warning
src and dst cannot alias the same vector.

◆ clear()

virtual void geosx::TrilinosPreconditioner::clear ( )
overridevirtual

Clean up the preconditioner setup.

Releases memory used and allows the matrix to be deleted cleanly. This method should be called before the matrix used to compute the preconditioner goes out of scope or is re-created. Some implementations require the matrix to outlive the preconditioner (for example, Trilinos/ML may crash the program if deleted after the matrix).

Note
Should be properly overridden in derived classes, which may call this method.

Reimplemented from geosx::PreconditionerBase< TrilinosInterface >.

◆ compute()

virtual void geosx::TrilinosPreconditioner::compute ( Matrix const &  mat)
overridevirtual

Compute the preconditioner from a matrix.

Parameters
matthe matrix to precondition.

◆ unwrapped() [1/2]

Epetra_Operator const& geosx::TrilinosPreconditioner::unwrapped ( ) const

Access the underlying Epetra preconditioning operator.

Returns
reference to the Epetra operator

◆ unwrapped() [2/2]

Epetra_Operator& geosx::TrilinosPreconditioner::unwrapped ( )

Access the underlying Epetra preconditioning operator.

Returns
reference to the Epetra operator

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