Abstract base class for linear operators. More...

#include <LinearOperator.hpp>

Inheritance diagram for geos::LinearOperator< VECTOR >:

[legend]

Public Types
using	Vector = VECTOR
	Alias for template parameter.

Public Member Functions
	LinearOperator ()=default
	Constructor.

virtual	~LinearOperator ()=default
	Destructor.

virtual void	apply (Vector const &src, Vector &dst) const =0
	Apply operator to a vector, `dst = this(src)`. More...

virtual void	residual (Vector const &x, Vector const &b, Vector &r) const
	Compute residual `r = b - this(x)`. More...

virtual globalIndex	numGlobalRows () const =0
	Get the number of global rows. More...

virtual globalIndex	numGlobalCols () const =0
	Get the number of global columns. More...

virtual localIndex	numLocalRows () const =0
	Get the number of local rows. More...

virtual localIndex	numLocalCols () const =0
	Get the number of local columns. More...

virtual MPI_Comm	comm () const =0
	Get the MPI communicator the matrix was created with. More...

Detailed Description

template<typename VECTOR>
class geos::LinearOperator< VECTOR >

Abstract base class for linear operators.

Template Parameters

VECTOR Type of vector this operator can be applied to

Definition at line 34 of file LinearOperator.hpp.

Member Function Documentation

◆ apply()

template<typename VECTOR >

virtual void geos::LinearOperator< VECTOR >::apply	(	Vector const &	src,
		Vector &	dst
	)		const

pure virtual

Apply operator to a vector, dst = this(src).

Parameters

src	input vector
dst	output vector

Warning: src and dst cannot alias the same vector (some implementations may allow this).

Implemented in geos::MatrixBase< MATRIX, VECTOR >, geos::MatrixBase< HypreMatrix, HypreVector >, geos::MatrixBase< PetscMatrix, PetscVector >, geos::MatrixBase< EpetraMatrix, EpetraVector >, geos::KrylovSolver< VECTOR >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::BlockOperatorView< VECTOR, LinearOperator< VECTOR > >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::HyprePreconditioner, geos::PetscMatrix, geos::HypreMatrix, and geos::EpetraMatrix.

◆ comm()

template<typename VECTOR >

virtual MPI_Comm geos::LinearOperator< VECTOR >::comm ( ) const

pure virtual

Get the MPI communicator the matrix was created with.

Returns: MPI communicator passed in create...()

Note: when build without MPI, may return anything (MPI_Comm will be a mock type defined in MpiWrapper)

Implemented in geos::KrylovSolver< VECTOR >, geos::TransposeOperator< LAI >, geos::NormalOperator< LAI >, geos::InverseNormalOperator< LAI, SOLVER >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::BlockOperatorView< VECTOR, LinearOperator< VECTOR > >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::EpetraMatrix, geos::PetscMatrix, geos::HypreMatrix, geos::PreconditionerBase< LAI >, geos::PreconditionerBase< PetscInterface >, geos::PreconditionerBase< HypreInterface >, and geos::PreconditionerBase< TrilinosInterface >.

◆ numGlobalCols()

template<typename VECTOR >

virtual globalIndex geos::LinearOperator< VECTOR >::numGlobalCols ( ) const

pure virtual

Get the number of global columns.

Returns: Number of global columns in the operator.

Implemented in geos::PreconditionerJacobi< LAI >, geos::KrylovSolver< VECTOR >, geos::TransposeOperator< LAI >, geos::NormalOperator< LAI >, geos::InverseNormalOperator< LAI, SOLVER >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::BlockOperatorView< VECTOR, LinearOperator< VECTOR > >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::EpetraMatrix, geos::PetscMatrix, geos::HypreMatrix, geos::PreconditionerBase< LAI >, geos::PreconditionerBase< PetscInterface >, geos::PreconditionerBase< HypreInterface >, and geos::PreconditionerBase< TrilinosInterface >.

◆ numGlobalRows()

template<typename VECTOR >

virtual globalIndex geos::LinearOperator< VECTOR >::numGlobalRows ( ) const

pure virtual

Get the number of global rows.

Returns: Number of global rows in the operator.

Implemented in geos::PreconditionerJacobi< LAI >, geos::KrylovSolver< VECTOR >, geos::TransposeOperator< LAI >, geos::NormalOperator< LAI >, geos::InverseNormalOperator< LAI, SOLVER >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::BlockOperatorView< VECTOR, LinearOperator< VECTOR > >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::EpetraMatrix, geos::PetscMatrix, geos::HypreMatrix, geos::PreconditionerBase< LAI >, geos::PreconditionerBase< PetscInterface >, geos::PreconditionerBase< HypreInterface >, and geos::PreconditionerBase< TrilinosInterface >.

◆ numLocalCols()

template<typename VECTOR >

virtual localIndex geos::LinearOperator< VECTOR >::numLocalCols ( ) const

pure virtual

Get the number of local columns.

Returns: Number of local columns in the operator.

Note: The use of term "local columns" refers not to physical partitioning of columns across ranks (as e.g. matrices are partitioned by rows and typically physically store all column entries), but to the partitioning of a compatible vector object that this operator can be applied to.

Implemented in geos::KrylovSolver< VECTOR >, geos::TransposeOperator< LAI >, geos::NormalOperator< LAI >, geos::InverseNormalOperator< LAI, SOLVER >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::BlockOperatorView< VECTOR, LinearOperator< VECTOR > >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::EpetraMatrix, geos::PetscMatrix, geos::HypreMatrix, geos::PreconditionerBase< LAI >, geos::PreconditionerBase< PetscInterface >, geos::PreconditionerBase< HypreInterface >, and geos::PreconditionerBase< TrilinosInterface >.

◆ numLocalRows()

template<typename VECTOR >

virtual localIndex geos::LinearOperator< VECTOR >::numLocalRows ( ) const

pure virtual

Get the number of local rows.

Returns: Number of local rows in the operator.

Implemented in geos::KrylovSolver< VECTOR >, geos::TransposeOperator< LAI >, geos::NormalOperator< LAI >, geos::InverseNormalOperator< LAI, SOLVER >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::BlockOperatorView< VECTOR, LinearOperator< VECTOR > >, geos::BlockOperatorView< VECTOR, OPERATOR >, geos::EpetraMatrix, geos::PetscMatrix, geos::HypreMatrix, geos::PreconditionerBase< LAI >, geos::PreconditionerBase< PetscInterface >, geos::PreconditionerBase< HypreInterface >, and geos::PreconditionerBase< TrilinosInterface >.

◆ residual()

template<typename VECTOR >

virtual void geos::LinearOperator< VECTOR >::residual	(	Vector const &	x,
		Vector const &	b,
		Vector &	r
	)		const

inlinevirtual

Compute residual r = b - this(x).

Parameters

x	Input solution.
b	Input right hand side.
r	Output residual.

Warning: b and x may alias the same vector. r cannot alias any of the other two vectors (some implementations may allow this).

Reimplemented in geos::MatrixBase< MATRIX, VECTOR >, geos::MatrixBase< HypreMatrix, HypreVector >, geos::MatrixBase< PetscMatrix, PetscVector >, and geos::MatrixBase< EpetraMatrix, EpetraVector >.

Definition at line 70 of file LinearOperator.hpp.

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

coreComponents/linearAlgebra/common/LinearOperator.hpp

Public Types

Public Member Functions

Detailed Description

template<typename VECTOR> class geos::LinearOperator< VECTOR >

Member Function Documentation

◆ apply()

◆ comm()

◆ numGlobalCols()

◆ numGlobalRows()

◆ numLocalCols()

◆ numLocalRows()

◆ residual()

template<typename VECTOR>
class geos::LinearOperator< VECTOR >