Epetra Package Browser (Single Doxygen Collection)  Development
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Protected Member Functions | Protected Attributes | List of all members
Epetra_BasicRowMatrix Class Referenceabstract

Epetra_BasicRowMatrix: A class for simplifying the development of Epetra_RowMatrix adapters. More...

#include <Epetra_BasicRowMatrix.h>

Inheritance diagram for Epetra_BasicRowMatrix:
Inheritance graph
[legend]

Protected Member Functions

void Setup ()
 
void UpdateImportVector (int NumVectors) const
 
void UpdateExportVector (int NumVectors) const
 
void SetImportExport ()
 
- Protected Member Functions inherited from Epetra_Object
std::string toString (const int &x) const
 
std::string toString (const long long &x) const
 
std::string toString (const double &x) const
 

Protected Attributes

Epetra_Comm * Comm_
 
Epetra_Map OperatorDomainMap_
 
Epetra_Map OperatorRangeMap_
 
Epetra_Map RowMatrixRowMap_
 
Epetra_Map RowMatrixColMap_
 
int NumMyNonzeros_
 
long long NumGlobalNonzeros_
 
int MaxNumEntries_
 
double NormInf_
 
double NormOne_
 
int NumMyRows_
 
int NumMyCols_
 
bool UseTranspose_
 
bool HasNormInf_
 
bool LowerTriangular_
 
bool UpperTriangular_
 
bool HaveStructureConstants_
 
bool HaveNumericConstants_
 
bool HaveMaps_
 
Epetra_MultiVector * ImportVector_
 
Epetra_MultiVector * ExportVector_
 
Epetra_Import * Importer_
 
Epetra_Export * Exporter_
 
- Protected Attributes inherited from Epetra_CompObject
Epetra_Flops * FlopCounter_
 

Constructor/Destructor

 Epetra_BasicRowMatrix (const Epetra_Comm &Comm)
 Epetra_BasicRowMatrix constructor. More...
 
virtual ~Epetra_BasicRowMatrix ()
 Epetra_BasicRowMatrix Destructor. More...
 

Setup functions

void SetMaps (const Epetra_Map &RowMap, const Epetra_Map &ColMap)
 Set maps (Version 1); call this function or the next, but not both. More...
 
void SetMaps (const Epetra_Map &RowMap, const Epetra_Map &ColMap, const Epetra_Map &DomainMap, const Epetra_Map &RangeMap)
 Set maps (Version 2); call this function or the previous, but not both. More...
 

User-required implementation methods

virtual int ExtractMyRowCopy (int MyRow, int Length, int &NumEntries, double *Values, int *Indices) const =0
 Returns a copy of the specified local row in user-provided arrays. More...
 
virtual int ExtractMyEntryView (int CurEntry, double *&Value, int &RowIndex, int &ColIndex)=0
 Returns a reference to the ith entry in the matrix, along with its row and column index. More...
 
virtual int ExtractMyEntryView (int CurEntry, double const *&Value, int &RowIndex, int &ColIndex) const =0
 Returns a const reference to the ith entry in the matrix, along with its row and column index. More...
 
virtual int NumMyRowEntries (int MyRow, int &NumEntries) const =0
 Return the current number of values stored for the specified local row. More...
 

Computational methods

virtual int Multiply (bool TransA, const Epetra_MultiVector &X, Epetra_MultiVector &Y) const
 Returns the result of a Epetra_BasicRowMatrix multiplied by a Epetra_MultiVector X in Y. More...
 
virtual int Solve (bool Upper, bool Trans, bool UnitDiagonal, const Epetra_MultiVector &X, Epetra_MultiVector &Y) const
 Returns the result of a Epetra_BasicRowMatrix solve with a Epetra_MultiVector X in Y (not implemented). More...
 
virtual int ExtractDiagonalCopy (Epetra_Vector &Diagonal) const
 Returns a copy of the main diagonal in a user-provided vector. More...
 
virtual int InvRowSums (Epetra_Vector &x) const
 Computes the sum of absolute values of the rows of the Epetra_BasicRowMatrix, results returned in x. More...
 
virtual int LeftScale (const Epetra_Vector &x)
 Scales the Epetra_BasicRowMatrix on the left with a Epetra_Vector x. More...
 
virtual int InvColSums (Epetra_Vector &x) const
 Computes the sum of absolute values of the columns of the Epetra_BasicRowMatrix, results returned in x. More...
 
virtual int RightScale (const Epetra_Vector &x)
 Scales the Epetra_BasicRowMatrix on the right with a Epetra_Vector x. More...
 

Matrix Properties Query Methods

virtual bool Filled () const
 If FillComplete() has been called, this query returns true, otherwise it returns false, presently always returns true. More...
 
bool LowerTriangular () const
 If matrix is lower triangular, this query returns true, otherwise it returns false. More...
 
virtual bool UpperTriangular () const
 If matrix is upper triangular, this query returns true, otherwise it returns false. More...
 

Attribute access functions

virtual double NormInf () const
 Returns the infinity norm of the global matrix. More...
 
virtual double NormOne () const
 Returns the one norm of the global matrix. More...
 
virtual int NumGlobalNonzeros () const
 Returns the number of nonzero entries in the global matrix. More...
 
virtual long long NumGlobalNonzeros64 () const
 
virtual int NumGlobalRows () const
 Returns the number of global matrix rows. More...
 
virtual long long NumGlobalRows64 () const
 
virtual int NumGlobalCols () const
 Returns the number of global matrix columns. More...
 
virtual long long NumGlobalCols64 () const
 
virtual int NumGlobalDiagonals () const
 Returns the number of global nonzero diagonal entries. More...
 
virtual long long NumGlobalDiagonals64 () const
 
virtual int NumMyNonzeros () const
 Returns the number of nonzero entries in the calling processor's portion of the matrix. More...
 
virtual int NumMyRows () const
 Returns the number of matrix rows owned by the calling processor. More...
 
virtual int NumMyCols () const
 Returns the number of matrix columns owned by the calling processor. More...
 
virtual int NumMyDiagonals () const
 Returns the number of local nonzero diagonal entries. More...
 
virtual int MaxNumEntries () const
 Returns the maximum number of nonzero entries across all rows on this processor. More...
 
virtual const Epetra_Map & OperatorDomainMap () const
 Returns the Epetra_Map object associated with the domain of this operator. More...
 
virtual const Epetra_Map & OperatorRangeMap () const
 Returns the Epetra_Map object associated with the range of this operator (same as domain). More...
 
virtual const Epetra_BlockMap & Map () const
 Implement the Epetra_SrcDistObjec::Map() function. More...
 
virtual const Epetra_Map & RowMatrixRowMap () const
 Returns the Row Map object needed for implementing Epetra_RowMatrix. More...
 
virtual const Epetra_Map & RowMatrixColMap () const
 Returns the Column Map object needed for implementing Epetra_RowMatrix. More...
 
virtual const Epetra_Import * RowMatrixImporter () const
 Returns the Epetra_Import object that contains the import operations for distributed operations. More...
 
virtual const Epetra_Comm & Comm () const
 Returns a pointer to the Epetra_Comm communicator associated with this matrix. More...
 

I/O Methods

virtual void Print (std::ostream &os) const
 Print method. More...
 

Additional methods required to support the Epetra_RowMatrix interface

virtual int SetUseTranspose (bool use_transpose)
 If set true, transpose of this operator will be applied. More...
 
virtual const char * Label () const
 Returns a character string describing the operator. More...
 
virtual int Apply (const Epetra_MultiVector &X, Epetra_MultiVector &Y) const
 Returns the result of a Epetra_RowMatrix applied to a Epetra_MultiVector X in Y. More...
 
virtual int ApplyInverse (const Epetra_MultiVector &X, Epetra_MultiVector &Y) const
 Returns the result of a Epetra_RowMatrix inverse applied to an Epetra_MultiVector X in Y. More...
 
bool HasNormInf () const
 Returns true because this class can compute an Inf-norm. More...
 
virtual bool UseTranspose () const
 Returns the current UseTranspose setting. More...
 

Additional accessor methods

virtual const Epetra_Import * Importer () const
 Returns the Epetra_Import object that contains the import operations for distributed operations, returns zero if none. More...
 
virtual const Epetra_Export * Exporter () const
 Returns the Epetra_Export object that contains the export operations for distributed operations, returns zero if none. More...
 

Post-construction modifications

virtual void ComputeStructureConstants () const
 Update the constants associated with the structure of the matrix: Call only if structure changes from the initial RowMatrix. More...
 
virtual void ComputeNumericConstants () const
 Update the constants associated with the values of the matrix: Call only if values changes from the initial RowMatrix. More...
 

Additional Inherited Members

- Public Member Functions inherited from Epetra_CompObject
Epetra_CompObject & operator= (const Epetra_CompObject &src)
 
 Epetra_CompObject ()
 Basic Epetra_CompObject constuctor. More...
 
 Epetra_CompObject (const Epetra_CompObject &Source)
 Epetra_CompObject copy constructor. More...
 
virtual ~Epetra_CompObject ()
 Epetra_CompObject destructor. More...
 
void SetFlopCounter (const Epetra_Flops &FlopCounter_in)
 Set the internal Epetra_Flops() pointer. More...
 
void SetFlopCounter (const Epetra_CompObject &CompObject)
 Set the internal Epetra_Flops() pointer to the flop counter of another Epetra_CompObject. More...
 
void UnsetFlopCounter ()
 Set the internal Epetra_Flops() pointer to 0 (no flops counted). More...
 
Epetra_Flops * GetFlopCounter () const
 Get the pointer to the Epetra_Flops() object associated with this object, returns 0 if none. More...
 
void ResetFlops () const
 Resets the number of floating point operations to zero for this multi-vector. More...
 
double Flops () const
 Returns the number of floating point operations with this multi-vector. More...
 
void UpdateFlops (int Flops_in) const
 Increment Flop count for this object. More...
 
void UpdateFlops (long int Flops_in) const
 Increment Flop count for this object. More...
 
void UpdateFlops (long long Flops_in) const
 Increment Flop count for this object. More...
 
void UpdateFlops (double Flops_in) const
 Increment Flop count for this object. More...
 
void UpdateFlops (float Flops_in) const
 Increment Flop count for this object. More...
 
- Public Member Functions inherited from Epetra_Object
 Epetra_Object (int TracebackModeIn=-1, bool set_label=true)
 Epetra_Object Constructor. More...
 
 Epetra_Object (const char *const Label, int TracebackModeIn=-1)
 Epetra_Object Constructor. More...
 
 Epetra_Object (const Epetra_Object &Object)
 Epetra_Object Copy Constructor. More...
 
virtual ~Epetra_Object ()
 Epetra_Object Destructor. More...
 
virtual void SetLabel (const char *const Label)
 Epetra_Object Label definition using char *. More...
 
virtual int ReportError (const std::string Message, int ErrorCode) const
 Error reporting method. More...
 
- Public Member Functions inherited from Epetra_RowMatrix
virtual ~Epetra_RowMatrix ()
 Destructor. More...
 
- Public Member Functions inherited from Epetra_Operator
virtual ~Epetra_Operator ()
 Destructor. More...
 
- Public Member Functions inherited from Epetra_SrcDistObject
virtual ~Epetra_SrcDistObject ()
 Epetra_SrcDistObject destructor. More...
 
- Static Public Member Functions inherited from Epetra_Object
static void SetTracebackMode (int TracebackModeValue)
 Set the value of the Epetra_Object error traceback report mode. More...
 
static int GetTracebackMode ()
 Get the value of the Epetra_Object error report mode. More...
 
static std::ostream & GetTracebackStream ()
 Get the output stream for error reporting. More...
 
- Static Public Attributes inherited from Epetra_Object
static int TracebackMode
 

Detailed Description

Epetra_BasicRowMatrix: A class for simplifying the development of Epetra_RowMatrix adapters. 

The Epetra_BasicRowMatrix is an adapter class for Epetra_RowMatrix that implements most of the Epetra_RowMatrix
methods using reasonable default implementations.  The Epetra_RowMatrix class has 39 pure virtual methods, requiring
the adapter class to implement all of them.
Epetra_BasicRowMatrix has only 4 pure virtual methods that must be implemented (See Epetra_JadMatrix for an example):
  1. ExtractMyRowCopy: Provide a row of values and indices for a specified local row.
  2. ExtractMyEntryView (const and non-const versions): Provide the memory address of the ith nonzero term stored on the calling processor, along with its corresponding local row and column index, where i goes from 0 to the NumMyNonzeros()-1. The order in which the nonzeros are traversed is not specified and is up to the adapter implementation.
  3. NumMyRowEntries: Provide the number of entries for a specified local row. 
 An alternative is possible if you do not want to provide a non-trivial implementation of the ExtraMyEntryView
 methods (See Epetra_VbrRowMatrix for an example):
  1. Implement ExtractMyRowCopy and NumMyRowEntries as above.
  2. Implement ExtractMyEntryView (both versions) returning a -1 integer code with no other executable code.
  3. Implement the RightScale and LeftScale methods non-trivially.

In addition, most adapters will probably re-implement the Multiply() method and perhaps the Solve() method, although one or the other may be implemented to return -1, signaling that there is no valid implementation. By default, the Multiply() method is implemented using ExtractMyRowCopy, which can usual be improved upon. By default Solve() and ApplyInverse() are implemented to return -1 (not implemented).

All other implemented methods in Epetra_BasicRowMatrix should not exhibit a signficant performance degradation, either because they are relatively small and fast, or because they are not a significant portion of the runtime for most codes. All methods are virtual, so they can be re-implemented by the adapter.

In addition to implementing the above methods, an adapter must inherit the Epetra_BasicRowMatrix interface and call the Epetra_BasicRowMatrix constructor as part of the adapter constructor. There are two constructors. The first requires the user to pass in the RowMap and ColMap, both of which are Epetra_Map objects. On each processor the RowMap (ColMap) must contain the global IDs (GIDs) of the rows (columns) that the processor cares about. The first constructor requires only these two maps, assuming that the RowMap will also serve as the DomainMap and RangeMap. In this case, the RowMap must be 1-to-1, meaning that if a global ID appears on one processor, it appears only once on that processor and does not appear on any other processor. For many sparse matrix data structures, it is the case that a given row is completely owned by one processor and that the global matrix is square. The first constructor is for this situation.

The second constructor allows the caller to specify all four maps. In this case the DomainMap, the layout of multivectors/vectors that are in the domain of the matrix (the x vector if computing y = A*x), must be 1-to-1. Also, the RangeMap, the layout of y must be 1-to-1. The RowMap and ColMap do not need to be 1-to-1, but the GIDs must be found in the RangeMap and DomainMap, respectively.

Note that Epetra_Operator is a base class for Epetra_RowMatrix, so any adapter for Epetra_BasicRowMatrix (or Epetra_RowMatrix) is also an adapter for Epetra_Operator.

An example of how to provide an adapter for Epetra_BasicRowMatrix can be found by looking at Epetra_JadMatrix.

Definition at line 118 of file Epetra_BasicRowMatrix.h.

Constructor & Destructor Documentation

Epetra_BasicRowMatrix::Epetra_BasicRowMatrix ( const Epetra_Comm &  Comm)

Epetra_BasicRowMatrix constructor.

This constructor requires a valid Epetra_Comm object as its only argument. The constructor will use Comm to build Epetra_Maps objects: RowMap, ColMap, DomainMap and RangeMap. However, these will be zero-length (trivial) maps that must be reset by calling one of the two SetMap() methods listed below.

Parameters
Comm[in] An Epetra_Comm containing a valid Comm object.

Definition at line 58 of file Epetra_BasicRowMatrix.cpp.

Epetra_BasicRowMatrix::~Epetra_BasicRowMatrix ( )
virtual

Epetra_BasicRowMatrix Destructor.

Definition at line 87 of file Epetra_BasicRowMatrix.cpp.

Member Function Documentation

void Epetra_BasicRowMatrix::SetMaps ( const Epetra_Map &  RowMap,
const Epetra_Map &  ColMap 
)

Set maps (Version 1); call this function or the next, but not both.

This method takes a row and column map. On each processor these maps describe the global rows and columns, resp, that the processor will care about. Note that the ColMap does not have to be one-to-one. In other words, a column ID can appear on more than one processor. The RowMap must be 1-to-1.

Parameters
RowMap[in] An Epetra_Map containing on each processor a list of GIDs of rows that the processor cares about.
ColMap[in] An Epetra_Map containing on each processor a list of GIDs of columns that the processor cares about.

In this method, the domain and range maps are assumed to be the same as the row map. Note that this requires that the global matrix be square. If the matrix is not square, or the domain vectors or range vectors do not have the same layout as the rows, then the second constructor should be called.

Definition at line 101 of file Epetra_BasicRowMatrix.cpp.

void Epetra_BasicRowMatrix::SetMaps ( const Epetra_Map &  RowMap,
const Epetra_Map &  ColMap,
const Epetra_Map &  DomainMap,
const Epetra_Map &  RangeMap 
)

Set maps (Version 2); call this function or the previous, but not both.

This constructor takes a row, column, domain and range map. On each processor these maps describe the global rows, columns, domain and range, resp, that the processor will care about. The domain and range maps must be one-to-one, but note that the row and column maps do not have to be one-to-one. In other words, a row ID can appear on more than one processor, as can a column ID.

Parameters
RowMap[in] An Epetra_Map containing on each processor a list of GIDs of rows that the processor cares about.
ColMap[in] An Epetra_Map containing on each processor a list of GIDs of columns that the processor cares about.
DomainMap[in] An Epetra_Map describing the distribution of domain vectors and multivectors.
RangeMap[in] An Epetra_Map describing the distribution of range vectors and multivectors.

Definition at line 107 of file Epetra_BasicRowMatrix.cpp.

virtual int Epetra_BasicRowMatrix::ExtractMyRowCopy ( int  MyRow,
int  Length,
int &  NumEntries,
double *  Values,
int *  Indices 
) const
pure virtual

Returns a copy of the specified local row in user-provided arrays.

Parameters
MyRow(In) - Local row to extract.
Length(In) - Length of Values and Indices.
NumEntries(Out) - Number of nonzero entries extracted.
Values(Out) - Extracted values for this row.
Indices(Out) - Extracted global column indices for the corresponding values.
Returns
Integer error code, set to 0 if successful, set to -1 if MyRow not valid, -2 if Length is too short (NumEntries will have required length).

Implements Epetra_RowMatrix.

Implemented in Epetra_VbrRowMatrix, and Epetra_JadMatrix.

virtual int Epetra_BasicRowMatrix::ExtractMyEntryView ( int  CurEntry,
double *&  Value,
int &  RowIndex,
int &  ColIndex 
)
pure virtual

Returns a reference to the ith entry in the matrix, along with its row and column index.

Parameters
CurEntry(In) - Index of local entry (from 0 to NumMyNonzeros()-1) to extract.
Value(Out) - Extracted reference to current values.
RowIndex(Out) - Row index for current entry.
ColIndex(Out) - Column index for current entry.
Returns
Integer error code, set to 0 if successful, set to -1 if CurEntry not valid.

Implemented in Epetra_VbrRowMatrix, and Epetra_JadMatrix.

virtual int Epetra_BasicRowMatrix::ExtractMyEntryView ( int  CurEntry,
double const *&  Value,
int &  RowIndex,
int &  ColIndex 
) const
pure virtual

Returns a const reference to the ith entry in the matrix, along with its row and column index.

Parameters
CurEntry(In) - Index of local entry (from 0 to NumMyNonzeros()-1) to extract.
Value(Out) - Extracted reference to current values.
RowIndex(Out) - Row index for current entry.
ColIndex(Out) - Column index for current entry.
Returns
Integer error code, set to 0 if successful, set to -1 if CurEntry not valid.

Implemented in Epetra_VbrRowMatrix, and Epetra_JadMatrix.

virtual int Epetra_BasicRowMatrix::NumMyRowEntries ( int  MyRow,
int &  NumEntries 
) const
pure virtual

Return the current number of values stored for the specified local row.

Similar to NumMyEntries() except NumEntries is returned as an argument and error checking is done on the input value MyRow.

Parameters
MyRow(In) - Local row.
NumEntries(Out) - Number of nonzero values.
Returns
Integer error code, set to 0 if successful, set to -1 if MyRow not valid.

Implements Epetra_RowMatrix.

Implemented in Epetra_VbrRowMatrix, and Epetra_JadMatrix.

int Epetra_BasicRowMatrix::Multiply ( bool  TransA,
const Epetra_MultiVector &  X,
Epetra_MultiVector &  Y 
) const
virtual

Returns the result of a Epetra_BasicRowMatrix multiplied by a Epetra_MultiVector X in Y.

Parameters
TransA(In) - If true, multiply by the transpose of matrix, otherwise just use matrix.
X(Out) - An Epetra_MultiVector of dimension NumVectors to multiply with matrix.
Y(Out) - An Epetra_MultiVector of dimension NumVectorscontaining result.
Returns
Integer error code, set to 0 if successful.

Implements Epetra_RowMatrix.

Reimplemented in Epetra_VbrRowMatrix, and Epetra_JadMatrix.

Definition at line 366 of file Epetra_BasicRowMatrix.cpp.

virtual int Epetra_BasicRowMatrix::Solve ( bool  Upper,
bool  Trans,
bool  UnitDiagonal,
const Epetra_MultiVector &  X,
Epetra_MultiVector &  Y 
) const
inlinevirtual

Returns the result of a Epetra_BasicRowMatrix solve with a Epetra_MultiVector X in Y (not implemented).

Parameters
Upper(In) - If true, solve Ux = y, otherwise solve Lx = y.
Trans(In) - If true, solve transpose problem.
UnitDiagonal(In) - If true, assume diagonal is unit (whether it's stored or not).
X(In) - An Epetra_MultiVector of dimension NumVectors to solve for.
Y(Out) - An Epetra_MultiVector of dimension NumVectors containing result.
Returns
Integer error code, set to 0 if successful.

Implements Epetra_RowMatrix.

Reimplemented in Epetra_VbrRowMatrix, and Epetra_JadMatrix.

Definition at line 242 of file Epetra_BasicRowMatrix.h.

int Epetra_BasicRowMatrix::ExtractDiagonalCopy ( Epetra_Vector &  Diagonal) const
virtual

Returns a copy of the main diagonal in a user-provided vector.

Parameters
Diagonal(Out) - Extracted main diagonal.
Returns
Integer error code, set to 0 if successful.

Implements Epetra_RowMatrix.

Definition at line 192 of file Epetra_BasicRowMatrix.cpp.

int Epetra_BasicRowMatrix::InvRowSums ( Epetra_Vector &  x) const
virtual

Computes the sum of absolute values of the rows of the Epetra_BasicRowMatrix, results returned in x. 

  The vector x will return such that x[i] will contain the inverse of sum of the absolute values of the
  \e this matrix will be scaled such that A(i,j) = x(i)*A(i,j) where i denotes the global row number of A
  and j denotes the global column number of A.  Using the resulting vector from this function as input to LeftScale()

will make the infinity norm of the resulting matrix exactly 1.

Parameters
x(Out) - An Epetra_Vector containing the row sums of the this matrix.
Warning
It is assumed that the distribution of x is the same as the rows of this.
Returns
Integer error code, set to 0 if successful.

Implements Epetra_RowMatrix.

Definition at line 218 of file Epetra_BasicRowMatrix.cpp.

int Epetra_BasicRowMatrix::LeftScale ( const Epetra_Vector &  x)
virtual

Scales the Epetra_BasicRowMatrix on the left with a Epetra_Vector x. 

The \e this matrix will be scaled such that A(i,j) = x(i)*A(i,j) where i denotes the row number of A
and j denotes the column number of A.
Parameters
x(In) - An Epetra_Vector to solve for.
Returns
Integer error code, set to 0 if successful.

Implements Epetra_RowMatrix.

Reimplemented in Epetra_VbrRowMatrix.

Definition at line 268 of file Epetra_BasicRowMatrix.cpp.

int Epetra_BasicRowMatrix::InvColSums ( Epetra_Vector &  x) const
virtual

Computes the sum of absolute values of the columns of the Epetra_BasicRowMatrix, results returned in x. 

  The vector x will return such that x[j] will contain the inverse of sum of the absolute values of the
  \e this matrix will be sca such that A(i,j) = x(j)*A(i,j) where i denotes the global row number of A
  and j denotes the global column number of A.  Using the resulting vector from this function as input to

RighttScale() will make the one norm of the resulting matrix exactly 1.

Parameters
x(Out) - An Epetra_Vector containing the column sums of the this matrix.
Warning
It is assumed that the distribution of x is the same as the rows of this.
Returns
Integer error code, set to 0 if successful.

Implements Epetra_RowMatrix.

Definition at line 292 of file Epetra_BasicRowMatrix.cpp.

int Epetra_BasicRowMatrix::RightScale ( const Epetra_Vector &  x)
virtual

Scales the Epetra_BasicRowMatrix on the right with a Epetra_Vector x. 

The \e this matrix will be scaled such that A(i,j) = x(j)*A(i,j) where i denotes the global row number of A
and j denotes the global column number of A.
Parameters
x(In) - The Epetra_Vector used for scaling this.
Returns
Integer error code, set to 0 if successful.

Implements Epetra_RowMatrix.

Reimplemented in Epetra_VbrRowMatrix.

Definition at line 342 of file Epetra_BasicRowMatrix.cpp.

virtual bool Epetra_BasicRowMatrix::Filled ( ) const
inlinevirtual

If FillComplete() has been called, this query returns true, otherwise it returns false, presently always returns true.

Implements Epetra_RowMatrix.

Definition at line 310 of file Epetra_BasicRowMatrix.h.

bool Epetra_BasicRowMatrix::LowerTriangular ( ) const
inlinevirtual

If matrix is lower triangular, this query returns true, otherwise it returns false.

Implements Epetra_RowMatrix.

Definition at line 313 of file Epetra_BasicRowMatrix.h.

virtual bool Epetra_BasicRowMatrix::UpperTriangular ( ) const
inlinevirtual

If matrix is upper triangular, this query returns true, otherwise it returns false.

Implements Epetra_RowMatrix.

Definition at line 316 of file Epetra_BasicRowMatrix.h.

virtual double Epetra_BasicRowMatrix::NormInf ( ) const
inlinevirtual

Returns the infinity norm of the global matrix.

Returns the quantity $ \| A \|_\infty$ such that

\[\| A \|_\infty = \max_{1\lei\lem} \sum_{j=1}^n |a_{ij}| \]

.

Warning
This method is supported if and only if the Epetra_RowMatrix Object that was used to create this supports this method.

Implements Epetra_RowMatrix.

Definition at line 331 of file Epetra_BasicRowMatrix.h.

virtual double Epetra_BasicRowMatrix::NormOne ( ) const
inlinevirtual

Returns the one norm of the global matrix.

Returns the quantity $ \| A \|_1$ such that

\[\| A \|_1= \max_{1\lej\len} \sum_{i=1}^m |a_{ij}| \]

.

Warning
This method is supported if and only if the Epetra_RowMatrix Object that was used to create this supports this method.

Implements Epetra_RowMatrix.

Definition at line 341 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::NumGlobalNonzeros ( ) const
inlinevirtual

Returns the number of nonzero entries in the global matrix.

Note that if the data decomposition is defined such that some nonzeros appear on multiple processors, then those nonzeros will be counted multiple times.

Implements Epetra_RowMatrix.

Definition at line 350 of file Epetra_BasicRowMatrix.h.

virtual long long Epetra_BasicRowMatrix::NumGlobalNonzeros64 ( ) const
inlinevirtual

Implements Epetra_RowMatrix.

Definition at line 360 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::NumGlobalRows ( ) const
inlinevirtual

Returns the number of global matrix rows.

Implements Epetra_RowMatrix.

Definition at line 364 of file Epetra_BasicRowMatrix.h.

virtual long long Epetra_BasicRowMatrix::NumGlobalRows64 ( ) const
inlinevirtual

Implements Epetra_RowMatrix.

Definition at line 372 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::NumGlobalCols ( ) const
inlinevirtual

Returns the number of global matrix columns.

Implements Epetra_RowMatrix.

Definition at line 376 of file Epetra_BasicRowMatrix.h.

virtual long long Epetra_BasicRowMatrix::NumGlobalCols64 ( ) const
inlinevirtual

Implements Epetra_RowMatrix.

Definition at line 384 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::NumGlobalDiagonals ( ) const
inlinevirtual

Returns the number of global nonzero diagonal entries.

Implements Epetra_RowMatrix.

Definition at line 388 of file Epetra_BasicRowMatrix.h.

virtual long long Epetra_BasicRowMatrix::NumGlobalDiagonals64 ( ) const
inlinevirtual

Implements Epetra_RowMatrix.

Definition at line 396 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::NumMyNonzeros ( ) const
inlinevirtual

Returns the number of nonzero entries in the calling processor's portion of the matrix.

Implements Epetra_RowMatrix.

Definition at line 399 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::NumMyRows ( ) const
inlinevirtual

Returns the number of matrix rows owned by the calling processor.

Implements Epetra_RowMatrix.

Definition at line 402 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::NumMyCols ( ) const
inlinevirtual

Returns the number of matrix columns owned by the calling processor.

Implements Epetra_RowMatrix.

Definition at line 405 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::NumMyDiagonals ( ) const
inlinevirtual

Returns the number of local nonzero diagonal entries.

Implements Epetra_RowMatrix.

Definition at line 408 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::MaxNumEntries ( ) const
inlinevirtual

Returns the maximum number of nonzero entries across all rows on this processor.

Implements Epetra_RowMatrix.

Definition at line 411 of file Epetra_BasicRowMatrix.h.

virtual const Epetra_Map& Epetra_BasicRowMatrix::OperatorDomainMap ( ) const
inlinevirtual

Returns the Epetra_Map object associated with the domain of this operator.

Implements Epetra_Operator.

Definition at line 414 of file Epetra_BasicRowMatrix.h.

virtual const Epetra_Map& Epetra_BasicRowMatrix::OperatorRangeMap ( ) const
inlinevirtual

Returns the Epetra_Map object associated with the range of this operator (same as domain).

Implements Epetra_Operator.

Definition at line 417 of file Epetra_BasicRowMatrix.h.

virtual const Epetra_BlockMap& Epetra_BasicRowMatrix::Map ( ) const
inlinevirtual

Implement the Epetra_SrcDistObjec::Map() function.

Implements Epetra_SrcDistObject.

Definition at line 420 of file Epetra_BasicRowMatrix.h.

virtual const Epetra_Map& Epetra_BasicRowMatrix::RowMatrixRowMap ( ) const
inlinevirtual

Returns the Row Map object needed for implementing Epetra_RowMatrix.

Implements Epetra_RowMatrix.

Definition at line 423 of file Epetra_BasicRowMatrix.h.

virtual const Epetra_Map& Epetra_BasicRowMatrix::RowMatrixColMap ( ) const
inlinevirtual

Returns the Column Map object needed for implementing Epetra_RowMatrix.

Implements Epetra_RowMatrix.

Definition at line 426 of file Epetra_BasicRowMatrix.h.

virtual const Epetra_Import* Epetra_BasicRowMatrix::RowMatrixImporter ( ) const
inlinevirtual

Returns the Epetra_Import object that contains the import operations for distributed operations.

Implements Epetra_RowMatrix.

Definition at line 429 of file Epetra_BasicRowMatrix.h.

virtual const Epetra_Comm& Epetra_BasicRowMatrix::Comm ( ) const
inlinevirtual

Returns a pointer to the Epetra_Comm communicator associated with this matrix.

Implements Epetra_Operator.

Definition at line 432 of file Epetra_BasicRowMatrix.h.

void Epetra_BasicRowMatrix::Print ( std::ostream &  os) const
virtual

Print method.

Reimplemented from Epetra_Object.

Definition at line 485 of file Epetra_BasicRowMatrix.cpp.

virtual int Epetra_BasicRowMatrix::SetUseTranspose ( bool  use_transpose)
inlinevirtual

If set true, transpose of this operator will be applied. 

  This flag allows the transpose of the given operator to be used implicitly.  Setting this flag
  affects only the Apply() and ApplyInverse() methods.  If the implementation of this interface

does not support transpose use, this method should return a value of -1.

Parameters
use_transpose(In) - If true, multiply by the transpose of operator, otherwise just use operator.
Returns
Always returns 0.

Implements Epetra_Operator.

Definition at line 455 of file Epetra_BasicRowMatrix.h.

virtual const char* Epetra_BasicRowMatrix::Label ( ) const
inlinevirtual

Returns a character string describing the operator.

Reimplemented from Epetra_Object.

Definition at line 458 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::Apply ( const Epetra_MultiVector &  X,
Epetra_MultiVector &  Y 
) const
inlinevirtual

Returns the result of a Epetra_RowMatrix applied to a Epetra_MultiVector X in Y.

Parameters
X(In) - A Epetra_MultiVector of dimension NumVectors to multiply with matrix.
Y(Out) - A Epetra_MultiVector of dimension NumVectors containing result.
Returns
Integer error code, set to 0 if successful.

Implements Epetra_Operator.

Definition at line 467 of file Epetra_BasicRowMatrix.h.

virtual int Epetra_BasicRowMatrix::ApplyInverse ( const Epetra_MultiVector &  X,
Epetra_MultiVector &  Y 
) const
inlinevirtual

Returns the result of a Epetra_RowMatrix inverse applied to an Epetra_MultiVector X in Y.

Parameters
X(In) - A Epetra_MultiVector of dimension NumVectors to solve for.
Y(Out) - A Epetra_MultiVector of dimension NumVectors containing result.
Returns
Integer error code = -1.
Warning
This method is NOT supported.

Implements Epetra_Operator.

Definition at line 479 of file Epetra_BasicRowMatrix.h.

bool Epetra_BasicRowMatrix::HasNormInf ( ) const
inlinevirtual

Returns true because this class can compute an Inf-norm.

Implements Epetra_Operator.

Definition at line 488 of file Epetra_BasicRowMatrix.h.

virtual bool Epetra_BasicRowMatrix::UseTranspose ( ) const
inlinevirtual

Returns the current UseTranspose setting.

Implements Epetra_Operator.

Definition at line 491 of file Epetra_BasicRowMatrix.h.

virtual const Epetra_Import* Epetra_BasicRowMatrix::Importer ( ) const
inlinevirtual

Returns the Epetra_Import object that contains the import operations for distributed operations, returns zero if none. 

  If RowMatrixColMap!=OperatorDomainMap, then this method returns a pointer to an Epetra_Import object that imports objects
  from an OperatorDomainMap layout to a RowMatrixColMap layout.  This operation is needed for sparse matrix-vector

multiplication, y = Ax, to gather x elements for local multiplication operations.

If RowMatrixColMap==OperatorDomainMap, then the pointer will be returned as 0.

Returns
Raw pointer to importer. This importer will be valid as long as the Epetra_RowMatrix object is valid.

Definition at line 507 of file Epetra_BasicRowMatrix.h.

virtual const Epetra_Export* Epetra_BasicRowMatrix::Exporter ( ) const
inlinevirtual

Returns the Epetra_Export object that contains the export operations for distributed operations, returns zero if none. 

  If RowMatrixRowMap!=OperatorRangeMap, then this method returns a pointer to an Epetra_Export object that exports objects
  from an RowMatrixRowMap layout to a OperatorRangeMap layout.  This operation is needed for sparse matrix-vector

multiplication, y = Ax, to scatter-add y elements generated during local multiplication operations.

If RowMatrixRowMap==OperatorRangeMap, then the pointer will be returned as 0. For a typical Epetra_RowMatrix object, this pointer will be zero since it is often the case that RowMatrixRowMap==OperatorRangeMap.

Returns
Raw pointer to exporter. This exporter will be valid as long as the Epetra_RowMatrix object is valid.

Definition at line 519 of file Epetra_BasicRowMatrix.h.

void Epetra_BasicRowMatrix::ComputeStructureConstants ( ) const
protectedvirtual

Update the constants associated with the structure of the matrix: Call only if structure changes from the initial RowMatrix.

Definition at line 138 of file Epetra_BasicRowMatrix.cpp.

void Epetra_BasicRowMatrix::ComputeNumericConstants ( ) const
protectedvirtual

Update the constants associated with the values of the matrix: Call only if values changes from the initial RowMatrix.

Definition at line 154 of file Epetra_BasicRowMatrix.cpp.

void Epetra_BasicRowMatrix::Setup ( )
protected
void Epetra_BasicRowMatrix::UpdateImportVector ( int  NumVectors) const
protected

Definition at line 456 of file Epetra_BasicRowMatrix.cpp.

void Epetra_BasicRowMatrix::UpdateExportVector ( int  NumVectors) const
protected

Definition at line 470 of file Epetra_BasicRowMatrix.cpp.

void Epetra_BasicRowMatrix::SetImportExport ( )
protected

Definition at line 124 of file Epetra_BasicRowMatrix.cpp.

Member Data Documentation

Epetra_Comm* Epetra_BasicRowMatrix::Comm_
protected

Definition at line 544 of file Epetra_BasicRowMatrix.h.

Epetra_Map Epetra_BasicRowMatrix::OperatorDomainMap_
protected

Definition at line 545 of file Epetra_BasicRowMatrix.h.

Epetra_Map Epetra_BasicRowMatrix::OperatorRangeMap_
protected

Definition at line 546 of file Epetra_BasicRowMatrix.h.

Epetra_Map Epetra_BasicRowMatrix::RowMatrixRowMap_
protected

Definition at line 547 of file Epetra_BasicRowMatrix.h.

Epetra_Map Epetra_BasicRowMatrix::RowMatrixColMap_
protected

Definition at line 548 of file Epetra_BasicRowMatrix.h.

int Epetra_BasicRowMatrix::NumMyNonzeros_
mutableprotected

Definition at line 550 of file Epetra_BasicRowMatrix.h.

long long Epetra_BasicRowMatrix::NumGlobalNonzeros_
mutableprotected

Definition at line 551 of file Epetra_BasicRowMatrix.h.

int Epetra_BasicRowMatrix::MaxNumEntries_
mutableprotected

Definition at line 552 of file Epetra_BasicRowMatrix.h.

double Epetra_BasicRowMatrix::NormInf_
mutableprotected

Definition at line 553 of file Epetra_BasicRowMatrix.h.

double Epetra_BasicRowMatrix::NormOne_
mutableprotected

Definition at line 554 of file Epetra_BasicRowMatrix.h.

int Epetra_BasicRowMatrix::NumMyRows_
protected

Definition at line 555 of file Epetra_BasicRowMatrix.h.

int Epetra_BasicRowMatrix::NumMyCols_
protected

Definition at line 556 of file Epetra_BasicRowMatrix.h.

bool Epetra_BasicRowMatrix::UseTranspose_
protected

Definition at line 558 of file Epetra_BasicRowMatrix.h.

bool Epetra_BasicRowMatrix::HasNormInf_
protected

Definition at line 559 of file Epetra_BasicRowMatrix.h.

bool Epetra_BasicRowMatrix::LowerTriangular_
mutableprotected

Definition at line 560 of file Epetra_BasicRowMatrix.h.

bool Epetra_BasicRowMatrix::UpperTriangular_
mutableprotected

Definition at line 561 of file Epetra_BasicRowMatrix.h.

bool Epetra_BasicRowMatrix::HaveStructureConstants_
mutableprotected

Definition at line 562 of file Epetra_BasicRowMatrix.h.

bool Epetra_BasicRowMatrix::HaveNumericConstants_
mutableprotected

Definition at line 563 of file Epetra_BasicRowMatrix.h.

bool Epetra_BasicRowMatrix::HaveMaps_
mutableprotected

Definition at line 564 of file Epetra_BasicRowMatrix.h.

Epetra_MultiVector* Epetra_BasicRowMatrix::ImportVector_
mutableprotected

Definition at line 567 of file Epetra_BasicRowMatrix.h.

Epetra_MultiVector* Epetra_BasicRowMatrix::ExportVector_
mutableprotected

Definition at line 568 of file Epetra_BasicRowMatrix.h.

Epetra_Import* Epetra_BasicRowMatrix::Importer_
protected

Definition at line 569 of file Epetra_BasicRowMatrix.h.

Epetra_Export* Epetra_BasicRowMatrix::Exporter_
protected

Definition at line 570 of file Epetra_BasicRowMatrix.h.

The documentation for this class was generated from the following files:
Generated on Thu Nov 21 2024 09:22:02 for Epetra Package Browser (Single Doxygen Collection) by   doxygen 1.8.5