Ifpack Package Browser (Single Doxygen Collection)
Development
|
Ifpack_ILU: A class for constructing and using an incomplete lower/upper (ILU) factorization of a given Epetra_RowMatrix. More...
#include <Ifpack_ILU.h>
Ifpack_ILU (Epetra_RowMatrix *A) | |
Constructor. More... | |
~Ifpack_ILU () | |
Destructor. More... | |
int | Initialize () |
Initialize the preconditioner, does not touch matrix values. More... | |
bool | IsInitialized () const |
Returns true if the preconditioner has been successfully initialized. More... | |
int | Compute () |
Compute ILU factors L and U using the specified graph, diagonal perturbation thresholds and relaxation parameters. More... | |
bool | IsComputed () const |
If factor is completed, this query returns true, otherwise it returns false. More... | |
int | SetParameters (Teuchos::ParameterList ¶meterlist) |
Set parameters using a Teuchos::ParameterList object. More... | |
int | SetUseTranspose (bool UseTranspose_in) |
If set true, transpose of this operator will be applied. More... | |
int | Apply (const Epetra_MultiVector &X, Epetra_MultiVector &Y) const |
int | Multiply (bool Trans, const Epetra_MultiVector &X, Epetra_MultiVector &Y) const |
int | ApplyInverse (const Epetra_MultiVector &X, Epetra_MultiVector &Y) const |
Returns the result of a Epetra_Operator inverse applied to an Epetra_MultiVector X in Y. More... | |
double | Condest (const Ifpack_CondestType CT=Ifpack_Cheap, const int MaxIters=1550, const double Tol=1e-9, Epetra_RowMatrix *Matrix_in=0) |
Computes the estimated condition number and returns the value. More... | |
double | Condest () const |
Returns the computed estimated condition number, or -1.0 if not computed. More... | |
const Epetra_CrsMatrix & | L () const |
Returns the address of the L factor associated with this factored matrix. More... | |
const Epetra_Vector & | D () const |
Returns the address of the D factor associated with this factored matrix. More... | |
const Epetra_CrsMatrix & | U () const |
Returns the address of the L factor associated with this factored matrix. More... | |
const char * | Label () const |
Returns a character string describing the operator. More... | |
int | SetLabel (const char *Label_in) |
Sets label for this object. More... | |
double | NormInf () const |
Returns 0.0 because this class cannot compute Inf-norm. More... | |
bool | HasNormInf () const |
Returns false because this class cannot compute an Inf-norm. More... | |
bool | UseTranspose () const |
Returns the current UseTranspose setting. More... | |
const Epetra_Map & | OperatorDomainMap () const |
Returns the Epetra_Map object associated with the domain of this operator. More... | |
const Epetra_Map & | OperatorRangeMap () const |
Returns the Epetra_Map object associated with the range of this operator. More... | |
const Epetra_Comm & | Comm () const |
Returns the Epetra_BlockMap object associated with the range of this matrix operator. More... | |
const Epetra_RowMatrix & | Matrix () const |
Returns a reference to the matrix to be preconditioned. More... | |
virtual std::ostream & | Print (std::ostream &os) const |
Prints on stream basic information about this object. More... | |
virtual int | NumInitialize () const |
Returns the number of calls to Initialize(). More... | |
virtual int | NumCompute () const |
Returns the number of calls to Compute(). More... | |
virtual int | NumApplyInverse () const |
Returns the number of calls to ApplyInverse(). More... | |
virtual double | InitializeTime () const |
Returns the time spent in Initialize(). More... | |
virtual double | ComputeTime () const |
Returns the time spent in Compute(). More... | |
virtual double | ApplyInverseTime () const |
Returns the time spent in ApplyInverse(). More... | |
virtual double | InitializeFlops () const |
Returns the number of flops in the initialization phase. More... | |
virtual double | ComputeFlops () const |
Returns the number of flops in the computation phase. More... | |
virtual double | ApplyInverseFlops () const |
Returns the number of flops in the application of the preconditioner. More... | |
Ifpack_ILU (const Ifpack_ILU &RHS) | |
Copy constructor (should never be used) More... | |
Ifpack_ILU & | operator= (const Ifpack_ILU &) |
operator= (should never be used) More... | |
void | Destroy () |
Destroys all internal data. More... | |
int | Solve (bool Trans, const Epetra_MultiVector &X, Epetra_MultiVector &Y) const |
Returns the result of a Ifpack_ILU forward/back solve on a Epetra_MultiVector X in Y. More... | |
int | ComputeSetup () |
int | InitAllValues (const Epetra_RowMatrix &A, int MaxNumEntries) |
int | LevelOfFill () const |
Returns the level of fill. More... | |
double | RelaxValue () const |
Get ILU(k) relaxation parameter. More... | |
double | AbsoluteThreshold () const |
Get absolute threshold value. More... | |
double | RelativeThreshold () const |
Get relative threshold value. More... | |
int | NumGlobalRows () const |
Returns the number of global matrix rows. More... | |
int | NumGlobalCols () const |
Returns the number of global matrix columns. More... | |
int | NumGlobalNonzeros () const |
Returns the number of nonzero entries in the global graph. More... | |
virtual int | NumGlobalBlockDiagonals () const |
Returns the number of diagonal entries found in the global input graph. More... | |
long long | NumGlobalRows64 () const |
long long | NumGlobalCols64 () const |
long long | NumGlobalNonzeros64 () const |
virtual long long | NumGlobalBlockDiagonals64 () const |
int | NumMyRows () const |
Returns the number of local matrix rows. More... | |
int | NumMyCols () const |
Returns the number of local matrix columns. More... | |
int | NumMyNonzeros () const |
Returns the number of nonzero entries in the local graph. More... | |
virtual int | NumMyBlockDiagonals () const |
Returns the number of diagonal entries found in the local input graph. More... | |
virtual int | NumMyDiagonals () const |
Returns the number of nonzero diagonal values found in matrix. More... | |
int | IndexBase () const |
Returns the index base for row and column indices for this graph. More... | |
long long | IndexBase64 () const |
const Ifpack_IlukGraph & | Graph () const |
Returns the address of the Ifpack_IlukGraph associated with this factored matrix. More... | |
Epetra_RowMatrix & | Matrix () |
Returns a reference to the matrix. More... | |
Teuchos::RefCountPtr < Epetra_RowMatrix > | A_ |
Pointer to the Epetra_RowMatrix to factorize. More... | |
Teuchos::RefCountPtr < Ifpack_IlukGraph > | Graph_ |
Teuchos::RefCountPtr < Epetra_CrsGraph > | CrsGraph_ |
Teuchos::RefCountPtr< Epetra_Map > | IlukRowMap_ |
Teuchos::RefCountPtr< Epetra_Map > | IlukDomainMap_ |
Teuchos::RefCountPtr< Epetra_Map > | IlukRangeMap_ |
const Epetra_Map * | U_DomainMap_ |
const Epetra_Map * | L_RangeMap_ |
const Epetra_Comm & | Comm_ |
Teuchos::RefCountPtr < Epetra_CrsMatrix > | L_ |
Contains the L factors. More... | |
Teuchos::RefCountPtr < Epetra_CrsMatrix > | U_ |
Contains the U factors. More... | |
Teuchos::RefCountPtr < Epetra_CrsGraph > | L_Graph_ |
Teuchos::RefCountPtr < Epetra_CrsGraph > | U_Graph_ |
Teuchos::RefCountPtr < Epetra_Vector > | D_ |
Diagonal of factors. More... | |
bool | UseTranspose_ |
int | NumMyDiagonals_ |
bool | Allocated_ |
bool | ValuesInitialized_ |
bool | Factored_ |
double | RelaxValue_ |
Relaxation value. More... | |
double | Athresh_ |
absolute threshold More... | |
double | Rthresh_ |
relative threshold More... | |
double | Condest_ |
condition number estimate More... | |
int | LevelOfFill_ |
Level of fill. More... | |
bool | IsInitialized_ |
If true , the preconditioner has been successfully initialized. More... | |
bool | IsComputed_ |
If true , the preconditioner has been successfully computed. More... | |
char | Label_ [160] |
Label of this object. More... | |
int | NumInitialize_ |
Contains the number of successful calls to Initialize(). More... | |
int | NumCompute_ |
Contains the number of successful call to Compute(). More... | |
int | NumApplyInverse_ |
Contains the number of successful call to ApplyInverse(). More... | |
double | InitializeTime_ |
Contains the time for all successful calls to Initialize(). More... | |
double | ComputeTime_ |
Contains the time for all successful calls to Compute(). More... | |
double | ApplyInverseTime_ |
Contains the time for all successful calls to ApplyInverse(). More... | |
double | ComputeFlops_ |
Contains the number of flops for Compute(). More... | |
double | ApplyInverseFlops_ |
Contain sthe number of flops for ApplyInverse(). More... | |
Epetra_Time | Time_ |
Used for timing issues. More... | |
Additional Inherited Members |
Ifpack_ILU: A class for constructing and using an incomplete lower/upper (ILU) factorization of a given Epetra_RowMatrix.
The Ifpack_ILU class computes a "relaxed" ILU factorization with level k fill of a given Epetra_RowMatrix. The notion of relaxation is the same as described in "Experimental study of ILU preconditioners for indefinite matrices" by Chow and Saad.
Please refer to ifp_ilu for a general description of the ILU algorithm.
The complete list of supported parameters is reported in page ifp_params.
Definition at line 83 of file Ifpack_ILU.h.
Ifpack_ILU::Ifpack_ILU | ( | Epetra_RowMatrix * | A | ) |
Constructor.
Definition at line 65 of file Ifpack_ILU.cpp.
|
inline |
Destructor.
Definition at line 91 of file Ifpack_ILU.h.
|
inlineprivate |
Copy constructor (should never be used)
Definition at line 294 of file Ifpack_ILU.h.
|
virtual |
Initialize the preconditioner, does not touch matrix values.
Implements Ifpack_Preconditioner.
Definition at line 239 of file Ifpack_ILU.cpp.
|
inlinevirtual |
Returns true
if the preconditioner has been successfully initialized.
Implements Ifpack_Preconditioner.
Definition at line 103 of file Ifpack_ILU.h.
|
virtual |
Compute ILU factors L and U using the specified graph, diagonal perturbation thresholds and relaxation parameters.
This function computes the ILU(k) factors L and U using the current:
InitValues() must be called before the factorization can proceed.
Implements Ifpack_Preconditioner.
Definition at line 334 of file Ifpack_ILU.cpp.
|
inlinevirtual |
If factor is completed, this query returns true, otherwise it returns false.
Implements Ifpack_Preconditioner.
Definition at line 120 of file Ifpack_ILU.h.
|
virtual |
Set parameters using a Teuchos::ParameterList object.
Implements Ifpack_Preconditioner.
Definition at line 100 of file Ifpack_ILU.cpp.
|
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.
UseTranspose_in | - (In) If true, multiply by the transpose of operator, otherwise just use operator. |
Implements Epetra_Operator.
Definition at line 145 of file Ifpack_ILU.h.
|
inlinevirtual |
Implements Epetra_Operator.
Definition at line 150 of file Ifpack_ILU.h.
int Ifpack_ILU::Multiply | ( | bool | Trans, |
const Epetra_MultiVector & | X, | ||
Epetra_MultiVector & | Y | ||
) | const |
Definition at line 535 of file Ifpack_ILU.cpp.
|
virtual |
Returns the result of a Epetra_Operator inverse applied to an Epetra_MultiVector X in Y.
In this implementation, we use several existing attributes to determine how virtual method ApplyInverse() should call the concrete method Solve(). We pass in the UpperTriangular(), the Epetra_CrsMatrix::UseTranspose(), and NoDiagonal() methods. The most notable warning is that if a matrix has no diagonal values we assume that there is an implicit unit diagonal that should be accounted for when doing a triangular solve.
X | - (In) A Epetra_MultiVector of dimension NumVectors to solve for. |
Out | Y - (Out) A Epetra_MultiVector of dimension NumVectors containing result. |
Implements Ifpack_Preconditioner.
Definition at line 575 of file Ifpack_ILU.cpp.
|
virtual |
Computes the estimated condition number and returns the value.
Implements Ifpack_Preconditioner.
Definition at line 615 of file Ifpack_ILU.cpp.
|
inlinevirtual |
Returns the computed estimated condition number, or -1.0 if not computed.
Implements Ifpack_Preconditioner.
Definition at line 182 of file Ifpack_ILU.h.
|
inline |
Returns the address of the L factor associated with this factored matrix.
Definition at line 191 of file Ifpack_ILU.h.
|
inline |
Returns the address of the D factor associated with this factored matrix.
Definition at line 194 of file Ifpack_ILU.h.
|
inline |
Returns the address of the L factor associated with this factored matrix.
Definition at line 197 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns a character string describing the operator.
Implements Epetra_Operator.
Definition at line 200 of file Ifpack_ILU.h.
|
inline |
Sets label for this
object.
Definition at line 203 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns 0.0 because this class cannot compute Inf-norm.
Implements Epetra_Operator.
Definition at line 210 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns false because this class cannot compute an Inf-norm.
Implements Epetra_Operator.
Definition at line 213 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the current UseTranspose setting.
Implements Epetra_Operator.
Definition at line 216 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the Epetra_Map object associated with the domain of this operator.
Implements Epetra_Operator.
Definition at line 219 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the Epetra_Map object associated with the range of this operator.
Implements Epetra_Operator.
Definition at line 222 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the Epetra_BlockMap object associated with the range of this matrix operator.
Implements Epetra_Operator.
Definition at line 225 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns a reference to the matrix to be preconditioned.
Implements Ifpack_Preconditioner.
Definition at line 228 of file Ifpack_ILU.h.
|
virtual |
Prints on stream basic information about this
object.
Implements Ifpack_Preconditioner.
Definition at line 634 of file Ifpack_ILU.cpp.
|
inlinevirtual |
Returns the number of calls to Initialize().
Implements Ifpack_Preconditioner.
Definition at line 237 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the number of calls to Compute().
Implements Ifpack_Preconditioner.
Definition at line 243 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the number of calls to ApplyInverse().
Implements Ifpack_Preconditioner.
Definition at line 249 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the time spent in Initialize().
Implements Ifpack_Preconditioner.
Definition at line 255 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the time spent in Compute().
Implements Ifpack_Preconditioner.
Definition at line 261 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the time spent in ApplyInverse().
Implements Ifpack_Preconditioner.
Definition at line 267 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the number of flops in the initialization phase.
Implements Ifpack_Preconditioner.
Definition at line 273 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the number of flops in the computation phase.
Implements Ifpack_Preconditioner.
Definition at line 278 of file Ifpack_ILU.h.
|
inlinevirtual |
Returns the number of flops in the application of the preconditioner.
Implements Ifpack_Preconditioner.
Definition at line 283 of file Ifpack_ILU.h.
|
inlineprivate |
operator= (should never be used)
Definition at line 300 of file Ifpack_ILU.h.
|
private |
Destroys all internal data.
Definition at line 92 of file Ifpack_ILU.cpp.
|
private |
Returns the result of a Ifpack_ILU forward/back solve on a Epetra_MultiVector X in Y.
In | Trans -If true, solve transpose problem. |
X | - (In) A Epetra_MultiVector of dimension NumVectors to solve for. |
Out | Y - (Out) A Epetra_MultiVector of dimension NumVectorscontaining result. |
Definition at line 500 of file Ifpack_ILU.cpp.
|
private |
Definition at line 115 of file Ifpack_ILU.cpp.
|
private |
|
inlineprivate |
Returns the level of fill.
Definition at line 325 of file Ifpack_ILU.h.
|
inlineprivate |
Get ILU(k) relaxation parameter.
Definition at line 328 of file Ifpack_ILU.h.
|
inlineprivate |
Get absolute threshold value.
Definition at line 331 of file Ifpack_ILU.h.
|
inlineprivate |
Get relative threshold value.
Definition at line 334 of file Ifpack_ILU.h.
|
inlineprivate |
Returns the number of global matrix rows.
Definition at line 338 of file Ifpack_ILU.h.
|
inlineprivate |
Returns the number of global matrix columns.
Definition at line 341 of file Ifpack_ILU.h.
|
inlineprivate |
Returns the number of nonzero entries in the global graph.
Definition at line 344 of file Ifpack_ILU.h.
|
inlineprivatevirtual |
Returns the number of diagonal entries found in the global input graph.
Definition at line 347 of file Ifpack_ILU.h.
|
inlineprivate |
Definition at line 350 of file Ifpack_ILU.h.
|
inlineprivate |
Definition at line 352 of file Ifpack_ILU.h.
|
inlineprivate |
Definition at line 354 of file Ifpack_ILU.h.
|
inlineprivatevirtual |
Definition at line 356 of file Ifpack_ILU.h.
|
inlineprivate |
Returns the number of local matrix rows.
Definition at line 359 of file Ifpack_ILU.h.
|
inlineprivate |
Returns the number of local matrix columns.
Definition at line 362 of file Ifpack_ILU.h.
|
inlineprivate |
Returns the number of nonzero entries in the local graph.
Definition at line 365 of file Ifpack_ILU.h.
|
inlineprivatevirtual |
Returns the number of diagonal entries found in the local input graph.
Definition at line 368 of file Ifpack_ILU.h.
|
inlineprivatevirtual |
Returns the number of nonzero diagonal values found in matrix.
Definition at line 371 of file Ifpack_ILU.h.
|
inlineprivate |
Returns the index base for row and column indices for this graph.
Definition at line 375 of file Ifpack_ILU.h.
|
inlineprivate |
Definition at line 377 of file Ifpack_ILU.h.
|
inlineprivate |
Returns the address of the Ifpack_IlukGraph associated with this factored matrix.
Definition at line 380 of file Ifpack_ILU.h.
|
inlineprivate |
Returns a reference to the matrix.
Definition at line 383 of file Ifpack_ILU.h.
|
private |
Pointer to the Epetra_RowMatrix to factorize.
Definition at line 392 of file Ifpack_ILU.h.
|
private |
Definition at line 393 of file Ifpack_ILU.h.
|
private |
Definition at line 394 of file Ifpack_ILU.h.
|
private |
Definition at line 395 of file Ifpack_ILU.h.
|
private |
Definition at line 396 of file Ifpack_ILU.h.
|
private |
Definition at line 397 of file Ifpack_ILU.h.
|
private |
Definition at line 398 of file Ifpack_ILU.h.
|
private |
Definition at line 399 of file Ifpack_ILU.h.
|
private |
Definition at line 400 of file Ifpack_ILU.h.
|
private |
Contains the L factors.
Definition at line 402 of file Ifpack_ILU.h.
|
private |
Contains the U factors.
Definition at line 404 of file Ifpack_ILU.h.
|
private |
Definition at line 405 of file Ifpack_ILU.h.
|
private |
Definition at line 406 of file Ifpack_ILU.h.
|
private |
Diagonal of factors.
Definition at line 408 of file Ifpack_ILU.h.
|
private |
Definition at line 409 of file Ifpack_ILU.h.
|
private |
Definition at line 411 of file Ifpack_ILU.h.
|
private |
Definition at line 412 of file Ifpack_ILU.h.
|
private |
Definition at line 413 of file Ifpack_ILU.h.
|
private |
Definition at line 414 of file Ifpack_ILU.h.
|
private |
Relaxation value.
Definition at line 416 of file Ifpack_ILU.h.
|
private |
absolute threshold
Definition at line 418 of file Ifpack_ILU.h.
|
private |
relative threshold
Definition at line 420 of file Ifpack_ILU.h.
|
private |
condition number estimate
Definition at line 422 of file Ifpack_ILU.h.
|
private |
Level of fill.
Definition at line 424 of file Ifpack_ILU.h.
|
private |
If true
, the preconditioner has been successfully initialized.
Definition at line 426 of file Ifpack_ILU.h.
|
private |
If true
, the preconditioner has been successfully computed.
Definition at line 428 of file Ifpack_ILU.h.
|
private |
Label of this
object.
Definition at line 430 of file Ifpack_ILU.h.
|
private |
Contains the number of successful calls to Initialize().
Definition at line 432 of file Ifpack_ILU.h.
|
private |
Contains the number of successful call to Compute().
Definition at line 434 of file Ifpack_ILU.h.
|
mutableprivate |
Contains the number of successful call to ApplyInverse().
Definition at line 436 of file Ifpack_ILU.h.
|
private |
Contains the time for all successful calls to Initialize().
Definition at line 438 of file Ifpack_ILU.h.
|
private |
Contains the time for all successful calls to Compute().
Definition at line 440 of file Ifpack_ILU.h.
|
mutableprivate |
Contains the time for all successful calls to ApplyInverse().
Definition at line 442 of file Ifpack_ILU.h.
|
private |
Contains the number of flops for Compute().
Definition at line 444 of file Ifpack_ILU.h.
|
mutableprivate |
Contain sthe number of flops for ApplyInverse().
Definition at line 446 of file Ifpack_ILU.h.
|
mutableprivate |
Used for timing issues.
Definition at line 448 of file Ifpack_ILU.h.