Ifpack_SparseContainer: a class for storing and solving linear systems using sparse matrices. More...

#include <Ifpack_SparseContainer.h>

Inheritance diagram for Ifpack_SparseContainer< T >:

Public Member Functions
virtual double	InitializeFlops () const
	Returns the flops in Compute(). More...

virtual double	ComputeFlops () const
	Returns the flops in Compute(). More...

virtual double	ApplyFlops () const
	Returns the flops in Apply(). More...

virtual double	ApplyInverseFlops () const
	Returns the flops in ApplyInverse(). More...

virtual std::ostream &	Print (std::ostream &os) const
	Prints basic information on iostream. This function is used by operator<<. More...

Public Member Functions inherited from Ifpack_Container
virtual	~Ifpack_Container ()
	Destructor. More...

Private Member Functions
virtual int	Extract (const Epetra_RowMatrix &Matrix_in)
	Extract the submatrices identified by the ID set int ID(). More...

Private Attributes
int	NumRows_
	Number of rows in the local matrix. More...

int	NumVectors_
	Number of vectors in the local linear system. More...

Teuchos::RefCountPtr< Epetra_Map >	Map_
	Linear map on which the local matrix is based. More...

Teuchos::RefCountPtr < Epetra_CrsMatrix >	Matrix_
	Pointer to the local matrix. More...

Teuchos::RefCountPtr < Epetra_MultiVector >	LHS_
	Solution vector. More...

Teuchos::RefCountPtr < Epetra_MultiVector >	RHS_
	right-hand side for local problems. More...

Epetra_IntSerialDenseVector	GID_
	Contains the subrows/subcols of A that will be inserted in Matrix_. More...

bool	IsInitialized_
	If `true`, the container has been successfully initialized. More...

bool	IsComputed_
	If `true`, the container has been successfully computed. More...

Teuchos::RefCountPtr< Epetra_Comm >	SerialComm_
	Serial communicator (containing only MPI_COMM_SELF if MPI is used). More...

Teuchos::RefCountPtr< T >	Inverse_
	Pointer to an Ifpack_Preconditioner object whose ApplyInverse() defined the action of the inverse of the local matrix. More...

std::string	Label_
	Label for `this` object. More...

Teuchos::ParameterList	List_

double	ApplyFlops_

	Ifpack_SparseContainer (const int NumRows, const int NumVectors=1)
	Constructor. More...

	Ifpack_SparseContainer (const Ifpack_SparseContainer< T > &rhs)
	Copy constructor. More...

virtual	~Ifpack_SparseContainer ()
	Destructor. More...

Ifpack_SparseContainer &	operator= (const Ifpack_SparseContainer< T > &rhs)
	Operator =. More...

virtual int	NumRows () const
	Returns the number of rows of the matrix and LHS/RHS. More...

virtual int	NumVectors () const
	Returns the number of vectors in LHS/RHS. More...

virtual int	SetNumVectors (const int NumVectors_in)
	Sets the number of vectors for LHS/RHS. More...

virtual double &	LHS (const int i, const int Vector=0)
	Returns the i-th component of the vector Vector of LHS. More...

virtual double &	RHS (const int i, const int Vector=0)
	Returns the i-th component of the vector Vector of RHS. More...

virtual int &	ID (const int i)
	Returns the ID associated to local row i. More...

virtual int	SetMatrixElement (const int row, const int col, const double value)
	Set the matrix element (row,col) to `value`. More...

virtual bool	IsInitialized () const
	Returns `true` is the container has been successfully initialized. More...

virtual bool	IsComputed () const
	Returns `true` is the container has been successfully computed. More...

virtual int	SetParameters (Teuchos::ParameterList &List)
	Sets all necessary parameters. More...

virtual const char *	Label () const
	Returns the label of this container. More...

Teuchos::RCP< const Epetra_Map >	Map () const
	Returns a pointer to the internally stored map. More...

Teuchos::RCP< const Epetra_MultiVector >	LHS () const
	Returns a pointer to the internally stored solution multi-vector. More...

Teuchos::RCP< const Epetra_MultiVector >	RHS () const
	Returns a pointer to the internally stored rhs multi-vector. More...

Teuchos::RCP< const Epetra_CrsMatrix >	Matrix () const
	Returns a pointer to the internally stored matrix. More...

const Epetra_IntSerialDenseVector &	ID () const
	Returns a pointer to the internally stored ID's. More...

Teuchos::RCP< const T >	Inverse () const
	Returns a pointer to the internally stored inverse operator. More...

virtual int	Initialize ()
	Initializes the container, by completing all the operations based on matrix structure. More...

virtual int	Compute (const Epetra_RowMatrix &Matrix_in)
	Finalizes the linear system matrix and prepares for the application of the inverse. More...

virtual int	Apply ()
	Apply the matrix to RHS, result is stored in LHS. More...

virtual int	ApplyInverse ()
	Apply the inverse of the matrix to RHS, result is stored in LHS. More...

virtual int	Destroy ()
	Destroys all data. More...

Detailed Description

template<typename T>
class Ifpack_SparseContainer< T >

Ifpack_SparseContainer: a class for storing and solving linear systems using sparse matrices.

To understand what an IFPACK container is, please refer to the documentation of the pure virtual class Ifpack_Container. Currently, containers are used by class Ifpack_BlockRelaxation.

Using block methods, one needs to store all diagonal blocks and to be also to apply the inverse of each diagonal block. Using class Ifpack_DenseContainer, one can store the blocks as sparse matrices (Epetra_CrsMatrix), which can be advantageous when the blocks are large. Otherwise, class Ifpack_DenseContainer is probably more appropriate.

Sparse containers are templated with a type T, which represent the class to use in the application of the inverse. (T is not used in Ifpack_DenseContainer). In SparseContainer, T must be an Ifpack_Preconditioner derived class. The container will allocate a T object, use SetParameters() and Compute(), then use T every time the linear system as to be solved (using the ApplyInverse() method of T).

Author: Marzio Sala, SNL 9214.

Date: Last modified on Nov-04.

Definition at line 93 of file Ifpack_SparseContainer.h.

Constructor & Destructor Documentation

template<typename T >

Ifpack_SparseContainer< T >::Ifpack_SparseContainer	(	const int	NumRows,
		const int	NumVectors = `1`
	)

Constructor.

Definition at line 314 of file Ifpack_SparseContainer.h.

template<typename T >

Ifpack_SparseContainer< T >::Ifpack_SparseContainer ( const Ifpack_SparseContainer< T > & rhs )

Copy constructor.

Definition at line 333 of file Ifpack_SparseContainer.h.

template<typename T >

Ifpack_SparseContainer< T >::~Ifpack_SparseContainer ( )

virtual

Destructor.

Definition at line 361 of file Ifpack_SparseContainer.h.

Member Function Documentation

template<typename T>

Ifpack_SparseContainer& Ifpack_SparseContainer< T >::operator= ( const Ifpack_SparseContainer< T > & rhs )

Operator =.

template<typename T >

int Ifpack_SparseContainer< T >::NumRows ( ) const

virtual

Returns the number of rows of the matrix and LHS/RHS.

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

template<typename T> class Ifpack_SparseContainer< T >

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

template<typename T>
class Ifpack_SparseContainer< T >