Ifpack Package Browser (Single Doxygen Collection)
Development
|
Ifpack_IKLU: A class for constructing and using an incomplete LU factorization of a given Epetra_RowMatrix. More...
#include <Ifpack_IKLU.h>
Ifpack_IKLU (const Epetra_RowMatrix *A) | |
Ifpack_IKLU constuctor with variable number of indices per row. More... | |
virtual | ~Ifpack_IKLU () |
Ifpack_IKLU Destructor. More... | |
int | SetParameters (Teuchos::ParameterList ¶meterlis) |
Set parameters using a Teuchos::ParameterList object. More... | |
int | Initialize () |
Initialize L and U with values from user matrix A. More... | |
bool | IsInitialized () const |
Returns true if the preconditioner has been successfully initialized. More... | |
int | Compute () |
Compute IC factor 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 | ApplyInverse (const Epetra_MultiVector &X, Epetra_MultiVector &Y) const |
Returns the result of a Ifpack_IKLU forward/back solve on a Epetra_MultiVector X in Y. More... | |
int | Apply (const Epetra_MultiVector &X, Epetra_MultiVector &Y) const |
double | Condest (const Ifpack_CondestType CT=Ifpack_Cheap, const int MaxIters=1550, const double Tol=1e-9, Epetra_RowMatrix *Matrix_in=0) |
Computed the estimated condition number and returns the value. More... | |
double | Condest () const |
Returns the computed estimated condition number, or -1.0 if no computed. More... | |
int | SetUseTranspose (bool UseTranspose_in) |
If set true, transpose of this operator will be applied. 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... | |
const Epetra_CrsMatrix & | L () const |
Returns a reference to the L factor. More... | |
const Epetra_CrsMatrix & | U () const |
Returns a reference to the U factor. More... | |
const char * | Label () const |
Returns the label of this object. More... | |
int | SetLabel (const char *Label_in) |
Sets the label for this object. More... | |
virtual std::ostream & | Print (std::ostream &os) const |
Prints basic information on iostream. This function is used by operator<<. 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... | |
double | LevelOfFill () const |
double | RelaxValue () const |
Set relative threshold value. More... | |
double | AbsoluteThreshold () const |
Get absolute threshold value. More... | |
double | RelativeThreshold () const |
Get relative threshold value. More... | |
double | DropTolerance () const |
Gets the dropping tolerance. More... | |
int | NumGlobalNonzeros () const |
Returns the number of nonzero entries in the global graph. More... | |
long long | NumGlobalNonzeros64 () const |
int | NumMyNonzeros () const |
Returns the number of nonzero entries in the local graph. More... | |
Ifpack_IKLU (const Ifpack_IKLU &RHS) | |
Copy constructor (should never be used) More... | |
Ifpack_IKLU & | operator= (const Ifpack_IKLU &) |
operator= (should never be used) More... | |
void | Destroy () |
Releases all allocated memory. More... | |
const Epetra_RowMatrix & | A_ |
reference to the matrix to be preconditioned. More... | |
const Epetra_Comm & | Comm_ |
Reference to the communicator object. More... | |
Teuchos::RefCountPtr < Epetra_CrsMatrix > | L_ |
L factor. More... | |
Teuchos::RefCountPtr < Epetra_CrsMatrix > | U_ |
U factor. More... | |
double | Condest_ |
Condition number estimate. More... | |
double | Relax_ |
relaxation value More... | |
double | Athresh_ |
Absolute threshold. More... | |
double | Rthresh_ |
Relative threshold. More... | |
double | LevelOfFill_ |
Level-of-fill. More... | |
double | DropTolerance_ |
Discards all elements below this tolerance. More... | |
std::string | Label_ |
Label for this object. More... | |
bool | IsInitialized_ |
true if this object has been initialized More... | |
bool | IsComputed_ |
true if this object has been computed More... | |
bool | UseTranspose_ |
true if transpose has to be used. More... | |
int | NumMyRows_ |
Number of local rows. More... | |
int | NumMyNonzeros_ |
Number of local nonzeros. 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 purposed. More... | |
long long | GlobalNonzeros_ |
Global number of nonzeros in L and U factors. More... | |
Teuchos::RefCountPtr < Epetra_SerialComm > | SerialComm_ |
Teuchos::RefCountPtr< Epetra_Map > | SerialMap_ |
csr * | csrA_ |
Containers for the matrix storage and permutation. More... | |
css * | cssS_ |
csrn * | csrnN_ |
Container for the L and U factor. More... | |
Additional Inherited Members |
Ifpack_IKLU: A class for constructing and using an incomplete LU factorization of a given Epetra_RowMatrix.
The Ifpack_IKLU class computes a "Relaxed" IKLU factorization with level k fill of a given Epetra_RowMatrix.
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 85 of file Ifpack_IKLU.h.
Ifpack_IKLU::Ifpack_IKLU | ( | const Epetra_RowMatrix * | A | ) |
Ifpack_IKLU constuctor with variable number of indices per row.
Definition at line 66 of file Ifpack_IKLU.cpp.
|
virtual |
Ifpack_IKLU Destructor.
Definition at line 97 of file Ifpack_IKLU.cpp.
|
inlineprivate |
Copy constructor (should never be used)
Definition at line 323 of file Ifpack_IKLU.h.
|
virtual |
Set parameters using a Teuchos::ParameterList object.
Implements Ifpack_Preconditioner.
Definition at line 116 of file Ifpack_IKLU.cpp.
|
virtual |
Initialize L and U with values from user matrix A.
Copies values from the user's matrix into the nonzero pattern of L and U.
In | A - User matrix to be factored. |
Implements Ifpack_Preconditioner.
Definition at line 153 of file Ifpack_IKLU.cpp.
|
inlinevirtual |
Returns true
if the preconditioner has been successfully initialized.
Implements Ifpack_Preconditioner.
Definition at line 117 of file Ifpack_IKLU.h.
|
virtual |
Compute IC factor U using the specified graph, diagonal perturbation thresholds and relaxation parameters.
This function computes the RILU(k) factors L and U using the current:
InitValues() must be called before the factorization can proceed.
Implements Ifpack_Preconditioner.
Definition at line 228 of file Ifpack_IKLU.cpp.
|
inlinevirtual |
If factor is completed, this query returns true, otherwise it returns false.
Implements Ifpack_Preconditioner.
Definition at line 134 of file Ifpack_IKLU.h.
|
virtual |
Returns the result of a Ifpack_IKLU forward/back solve on a Epetra_MultiVector X in Y.
X | - (In) A Epetra_MultiVector of dimension NumVectors to solve for. |
Y | - (Out) A Epetra_MultiVector of dimension NumVectorscontaining result. |
Implements Ifpack_Preconditioner.
Definition at line 335 of file Ifpack_IKLU.cpp.
|
virtual |
Implements Epetra_Operator.
Definition at line 399 of file Ifpack_IKLU.cpp.
|
virtual |
Computed the estimated condition number and returns the value.
Implements Ifpack_Preconditioner.
Definition at line 407 of file Ifpack_IKLU.cpp.
|
inlinevirtual |
Returns the computed estimated condition number, or -1.0 if no computed.
Implements Ifpack_Preconditioner.
Definition at line 158 of file Ifpack_IKLU.h.
|
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 173 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns 0.0 because this class cannot compute Inf-norm.
Implements Epetra_Operator.
Definition at line 176 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns false because this class cannot compute an Inf-norm.
Implements Epetra_Operator.
Definition at line 179 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the current UseTranspose setting.
Implements Epetra_Operator.
Definition at line 182 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the Epetra_Map object associated with the domain of this operator.
Implements Epetra_Operator.
Definition at line 185 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the Epetra_Map object associated with the range of this operator.
Implements Epetra_Operator.
Definition at line 188 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the Epetra_BlockMap object associated with the range of this matrix operator.
Implements Epetra_Operator.
Definition at line 191 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns a reference to the matrix to be preconditioned.
Implements Ifpack_Preconditioner.
Definition at line 194 of file Ifpack_IKLU.h.
|
inline |
Returns a reference to the L factor.
Definition at line 200 of file Ifpack_IKLU.h.
|
inline |
Returns a reference to the U factor.
Definition at line 203 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the label of this
object.
Implements Epetra_Operator.
Definition at line 206 of file Ifpack_IKLU.h.
|
inline |
Sets the label for this
object.
Definition at line 212 of file Ifpack_IKLU.h.
|
virtual |
Prints basic information on iostream. This function is used by operator<<.
Implements Ifpack_Preconditioner.
Definition at line 423 of file Ifpack_IKLU.cpp.
|
inlinevirtual |
Returns the number of calls to Initialize().
Implements Ifpack_Preconditioner.
Definition at line 222 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the number of calls to Compute().
Implements Ifpack_Preconditioner.
Definition at line 228 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the number of calls to ApplyInverse().
Implements Ifpack_Preconditioner.
Definition at line 234 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the time spent in Initialize().
Implements Ifpack_Preconditioner.
Definition at line 240 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the time spent in Compute().
Implements Ifpack_Preconditioner.
Definition at line 246 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the time spent in ApplyInverse().
Implements Ifpack_Preconditioner.
Definition at line 252 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the number of flops in the initialization phase.
Implements Ifpack_Preconditioner.
Definition at line 258 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the number of flops in the computation phase.
Implements Ifpack_Preconditioner.
Definition at line 263 of file Ifpack_IKLU.h.
|
inlinevirtual |
Returns the number of flops in the application of the preconditioner.
Implements Ifpack_Preconditioner.
Definition at line 268 of file Ifpack_IKLU.h.
|
inline |
Definition at line 273 of file Ifpack_IKLU.h.
|
inline |
Set relative threshold value.
Definition at line 278 of file Ifpack_IKLU.h.
|
inline |
Get absolute threshold value.
Definition at line 283 of file Ifpack_IKLU.h.
|
inline |
Get relative threshold value.
Definition at line 289 of file Ifpack_IKLU.h.
|
inline |
Gets the dropping tolerance.
Definition at line 295 of file Ifpack_IKLU.h.
|
inline |
Returns the number of nonzero entries in the global graph.
Definition at line 302 of file Ifpack_IKLU.h.
|
inline |
Definition at line 307 of file Ifpack_IKLU.h.
|
inline |
Returns the number of nonzero entries in the local graph.
Definition at line 313 of file Ifpack_IKLU.h.
|
inlineprivate |
operator= (should never be used)
Definition at line 330 of file Ifpack_IKLU.h.
|
private |
Releases all allocated memory.
Definition at line 103 of file Ifpack_IKLU.cpp.
|
private |
reference to the matrix to be preconditioned.
Definition at line 342 of file Ifpack_IKLU.h.
|
private |
Reference to the communicator object.
Definition at line 344 of file Ifpack_IKLU.h.
|
private |
L factor.
Definition at line 346 of file Ifpack_IKLU.h.
|
private |
U factor.
Definition at line 348 of file Ifpack_IKLU.h.
|
private |
Condition number estimate.
Definition at line 350 of file Ifpack_IKLU.h.
|
private |
relaxation value
Definition at line 352 of file Ifpack_IKLU.h.
|
private |
Absolute threshold.
Definition at line 354 of file Ifpack_IKLU.h.
|
private |
Relative threshold.
Definition at line 356 of file Ifpack_IKLU.h.
|
private |
Level-of-fill.
Definition at line 358 of file Ifpack_IKLU.h.
|
private |
Discards all elements below this tolerance.
Definition at line 360 of file Ifpack_IKLU.h.
|
private |
Label for this
object.
Definition at line 362 of file Ifpack_IKLU.h.
|
private |
true
if this
object has been initialized
Definition at line 364 of file Ifpack_IKLU.h.
|
private |
true
if this
object has been computed
Definition at line 366 of file Ifpack_IKLU.h.
|
private |
true
if transpose has to be used.
Definition at line 368 of file Ifpack_IKLU.h.
|
private |
Number of local rows.
Definition at line 370 of file Ifpack_IKLU.h.
|
private |
Number of local nonzeros.
Definition at line 372 of file Ifpack_IKLU.h.
|
private |
Contains the number of successful calls to Initialize().
Definition at line 374 of file Ifpack_IKLU.h.
|
private |
Contains the number of successful call to Compute().
Definition at line 376 of file Ifpack_IKLU.h.
|
mutableprivate |
Contains the number of successful call to ApplyInverse().
Definition at line 378 of file Ifpack_IKLU.h.
|
private |
Contains the time for all successful calls to Initialize().
Definition at line 380 of file Ifpack_IKLU.h.
|
private |
Contains the time for all successful calls to Compute().
Definition at line 382 of file Ifpack_IKLU.h.
|
mutableprivate |
Contains the time for all successful calls to ApplyInverse().
Definition at line 384 of file Ifpack_IKLU.h.
|
private |
Contains the number of flops for Compute().
Definition at line 386 of file Ifpack_IKLU.h.
|
mutableprivate |
Contain sthe number of flops for ApplyInverse().
Definition at line 388 of file Ifpack_IKLU.h.
|
mutableprivate |
Used for timing purposed.
Definition at line 390 of file Ifpack_IKLU.h.
|
private |
Global number of nonzeros in L and U factors.
Definition at line 392 of file Ifpack_IKLU.h.
|
private |
Definition at line 393 of file Ifpack_IKLU.h.
|
private |
Definition at line 394 of file Ifpack_IKLU.h.
|
private |
Containers for the matrix storage and permutation.
Definition at line 397 of file Ifpack_IKLU.h.
|
private |
Definition at line 398 of file Ifpack_IKLU.h.
|
private |
Container for the L and U factor.
Definition at line 400 of file Ifpack_IKLU.h.