ML  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
Namespaces | Macros | Functions
ml_epetra_utils.h File Reference

Interface to the Trilinos package Anasazi. More...

#include "ml_common.h"
#include <mpi.h>
#include "ml_include.h"
#include <iostream>
#include "EpetraExt_SolverMap_CrsMatrix.h"
#include "Epetra_DataAccess.h"
Include dependency graph for ml_epetra_utils.h:
This graph shows which files directly or indirectly include this file:

Namespaces

 Teuchos
 
 ML_Epetra
 ML_Epetra: default namespace for all Epetra interfaces.
 

Functions

int ML_Epetra_matvec (ML_Operator *data, int in, double *p, int out, double *ap)
 Matrix-vector function for Epetra matrices. More...
 
int ML_Epetra_RowMatrix_matvec (ML_Operator *data, int in, double *p, int out, double *ap)
 
int ML_Epetra_CrsMatrix_matvec (ML_Operator *data, int in, double *p, int out, double *ap)
 
int ML_Epetra_VbrMatrix_matvec (ML_Operator *data, int in, double *p, int out, double *ap)
 
int Epetra_ML_GetCrsDataptrs (ML_Operator *data, double **values, int **cols, int **rowptr)
 
int ML_Epetra_getrow (ML_Operator *data, int N_requested_rows, int requested_rows[], int allocated_space, int columns[], double values[], int row_lengths[])
 Getrow function for matrix of type Epetra_RowMatrix. More...
 
int ML_Epetra_RowMatrix_getrow (ML_Operator *data, int N_requested_rows, int requested_rows[], int allocated_space, int columns[], double values[], int row_lengths[])
 
int ML_Epetra_CrsMatrix_getrow (ML_Operator *data, int N_requested_rows, int requested_rows[], int allocated_space, int columns[], double values[], int row_lengths[])
 
int ML_Epetra_CrsMatrix_get_one_row (ML_Operator *data, int N_requested_rows, int requested_rows[], int allocated_space, int columns[], double values[], int row_lengths[])
 
int ML_Epetra_VbrMatrix_getrow (ML_Operator *data, int N_requested_rows, int requested_rows[], int allocated_space, int columns[], double values[], int row_lengths[])
 
void ML_Set_Filter (Teuchos::ParameterList &List)
 
int ML_Epetra_matvec_Filter (ML_Operator *data, int in, double *p, int out, double *ap)
 
int ML_Epetra_getrow_Filter (ML_Operator *data, int N_requested_rows, int requested_rows[], int allocated_space, int columns[], double values[], int row_lengths[])
 
int ML_Epetra_comm_wrapper (double vec[], void *data)
 Update vec's ghost node via communication. More...
 
int ML_Epetra_CrsMatrix_comm_wrapper (double vec[], void *data)
 
int ML_Epetra_VbrMatrix_comm_wrapper (double vec[], void *data)
 
int ML_Epetra_CrsGraph_comm_wrapper (double vec[], void *data)
 
int ML_Epetra_CrsGraph_matvec (ML_Operator *data, int in, double *p, int out, double *ap)
 
int ML_Epetra_CrsGraph_getrow (ML_Operator *data, int N_requested_rows, int requested_rows[], int allocated_space, int columns[], double values[], int row_lengths[])
 
int ML_Operator_WrapEpetraCrsGraph (Epetra_CrsGraph *Graph, ML_Operator *newMatrix)
 
void ML_CreateSublists (const Teuchos::ParameterList &List, Teuchos::ParameterList &newList)
 
int EpetraMatrix2MLMatrix (ML *ml_handle, int level, Epetra_RowMatrix *Amat)
 Wraps an Epetra_RowMatrix into an ML_Operators. More...
 
int ML_Operator_WrapEpetraMatrix (Epetra_RowMatrix *A, ML_Operator *Result)
 Wraps an Epetra_RowMatrix into an ML_Operators, for the given level. More...
 
int ML_Operator_WrapEpetraCrsMatrix (Epetra_CrsMatrix *A, ML_Operator *newMatrix, bool verbose=false)
 Wraps an Epetra_CrsMatrix into an ML_Operator, for the given level. More...
 
void Epetra_CrsMatrix_Wrap_ML_Operator (ML_Operator *A, const Epetra_Comm &Comm, const Epetra_Map &RowMap, Epetra_CrsMatrix **Result, Epetra_DataAccess CV=::View, int base=0)
 Wraps a ML_Operator into a Epetra_CrsMatrix. More...
 
Epetra_CrsMatrixEpetra_MatrixMult (Epetra_RowMatrix *B, Epetra_RowMatrix *Bt)
 Multiplies two Epetra_RowMatrix's, returns the results as an Epetra_CrsMatrix.
 
Epetra_CrsMatrixEpetra_MatrixAdd (Epetra_RowMatrix *B, Epetra_RowMatrix *Bt, double scalar)
 Adds two Epetra_RowMatrix's, returns the result as an Epetra_CrsMatrix.
 
int ML_Epetra_CRSinsert (ML_Operator *, int, int *, double *, int)
 
int ML_Operator2EpetraCrsMatrix (ML_Operator *Ke, Epetra_CrsMatrix *&CrsMatrix, int &MaxNumNonzeros, bool CheckNonzeroRow, double &, int base=0, bool verbose=false)
 Converts an ML_Operator into an Epetra_CrsMatrix. More...
 
int ML_Operator2EpetraCrsMatrix (ML_Operator *Ke, Epetra_CrsMatrix *&CrsMatrix)
 
Epetra_MapEpetra_ML_readupdatevector (char *filename, Epetra_Comm &comm)
 
Epetra_CrsMatrixEpetra_ML_readaztecmatrix (char *filename, Epetra_Map &map, Epetra_Comm &comm)
 
int ML_Epetra::ML_Epetra_PtAP (const Epetra_CrsMatrix &A, const Epetra_CrsMatrix &P, Epetra_CrsMatrix *&Result, bool verbose=false)
 Does an P^TAP for Epetra_CrsMatrices using ML's kernels.
 
int ML_Epetra::ML_Epetra_RAP (const Epetra_CrsMatrix &A, const Epetra_CrsMatrix &P, const Epetra_CrsMatrix &R, Epetra_CrsMatrix *&Result, bool verbose)
 Does an RAP for Epetra_CrsMatrices using ML's kernels.
 
int ML_Epetra::Epetra_PtAP (const Epetra_CrsMatrix &A, const Epetra_CrsMatrix &P, Epetra_CrsMatrix *&Result, bool keep_zero_rows=false, bool verbose=false)
 Does an P^TAP for Epetra_CrsMatrices using EpetraExt's kernels.
 
int * ML_Epetra::FindLocalDiricheltRowsFromOnesAndZeros (const Epetra_CrsMatrix &Matrix, int &numBCRows)
 Finds the Dirichlet rows in a square matrix that got the one-and-zeros. More...
 
void ML_Epetra::Apply_BCsToMatrixColumns (const int *dirichletRows, int numBCRows, const Epetra_CrsMatrix &Matrix)
 Applies Dirichlet conditions to columns that rows already have. More...
 
void ML_Epetra::Apply_BCsToMatrixRows (const int *dirichletRows, int numBCRows, const Epetra_CrsMatrix &Matrix)
 Applies Dirichlet conditions to matrix rows.
 
void ML_Epetra::Apply_BCsToMatrixColumns (const Epetra_RowMatrix &iBoundaryMatrix, const Epetra_RowMatrix &iMatrix)
 Applies Dirichlet conditions to columns that rows already have. More...
 
void ML_Epetra::Apply_BCsToMatrixColumns (const Epetra_IntVector &dirichletColumns, const Epetra_CrsMatrix &Matrix)
 
void ML_Epetra::Apply_BCsToGradient (const Epetra_RowMatrix &EdgeMatrix, const Epetra_RowMatrix &T)
 Applies boundary conditions to gradient matrix. (Maxwell's equations)
 
void ML_Epetra::Apply_OAZToMatrix (int *dirichletRows, int numBCRows, const Epetra_CrsMatrix &Matrix)
 Does Row/Column OAZ to a matrix.
 
Epetra_IntVectorML_Epetra::LocalRowstoColumns (int *Rows, int numRows, const Epetra_CrsMatrix &Matrix)
 Returns the local column numbers of the local rows passed in.
 
Epetra_IntVectorML_Epetra::FindLocalDirichletColumnsFromRows (const int *dirichletRows, int numBCRows, const Epetra_CrsMatrix &Matrix)
 Finds Dirichlet the local Dirichlet columns, given the local Dirichlet rows.
 
void ML_Epetra::Remove_Zeroed_Rows (const Epetra_CrsMatrix &Matrix, double tol=0.0)
 Drops a 1 on the diagonal of zero'd our rows.
 
Epetra_RowMatrixML_Epetra::ModifyEpetraMatrixColMap (const Epetra_RowMatrix &A, EpetraExt::CrsMatrix_SolverMap &transform, const char *matrixName=0, bool verbose=false)
 Transforms Epetra matrix column map (if necessary) to be compatible with. More...
 
int ML_Epetra::UpdateList (Teuchos::ParameterList &source, Teuchos::ParameterList &dest, bool OverWrite)
 
int ML_Operator_Destroy_DiscreteLaplacian ()
 
int ML_Operator_DiscreteLaplacian (ML_Operator *Op, int SymmetricPattern, double *x_coord, double *y_coord, double *z_coord, double theta, ML_Operator **NewOp)
 
bool Epetra_ML_readaztecvector (char *filename, Epetra_MultiVector &Vector, Epetra_Map &map, Epetra_Comm &comm, int ivec)
 
bool Epetra_ML_readvariableblocks (char *filename, Epetra_Map &map, Epetra_Comm &comm, int **blocks, int **block_pde)
 
bool Epetra_ML_writegidviz (char *filename, int label, Epetra_MultiVector &vector, int ivec, Epetra_Map &map, Epetra_Comm &comm)
 
void ML_BreakForDebugger (const Epetra_Comm &comm)
 Stops the code, waiting for a debugger to attach. More...
 

Detailed Description

Interface to the Trilinos package Anasazi.

Date
Last update to Doxygen: 22-Jul-04

Function Documentation

void Epetra_CrsMatrix_Wrap_ML_Operator ( ML_Operator A,
const Epetra_Comm Comm,
const Epetra_Map RowMap,
Epetra_CrsMatrix **  Result,
Epetra_DataAccess  CV = ::View,
int  base = 0 
)

Wraps a ML_Operator into a Epetra_CrsMatrix.

This is a somewhat cheap wrap in that the pointers get dumped into the Epetra_CrsMatrix.

int EpetraMatrix2MLMatrix ( ML ml_handle,
int  level,
Epetra_RowMatrix Amat 
)

Wraps an Epetra_RowMatrix into an ML_Operators.

This function creates an ML_Operator that is based on the input Epetra_RowMatrix. This is a "cheap" wrap in the sense that only function and pointers are created. Data is still coded as an Epetra_RowMatrix.

Note
ML requires A->RowMatrixRowMap() == A->OperatorRangeMap()
void ML_BreakForDebugger ( const Epetra_Comm comm)

Stops the code, waiting for a debugger to attach.

BreakForDebugger() is useful when the user wants to attach to the running process(es). This is a very easy task for serial runs – just run gdb. Parallel runs may result more problematic. In this case, one can proceed as follows:

  • Either define the enviromental variable ML_BREAK_FOR_DEBUGGER or create an empty file called ML_Debug_Now
  • Run the parallel code on a terminal (example, mpirun -np 4 ml_example.exe )
  • The code will stop and print each process ID.
  • In another terminal, attach to the desired process.
  • Type one character to let the code continue, and debug as required.

Referenced by ML_Epetra::MultiLevelPreconditioner::ComputePreconditioner().

int ML_Epetra_comm_wrapper ( double  vec[],
void *  data 
)

Update vec's ghost node via communication.

Update vec's ghost node via communication. Note: the length of vec is given by N_local + N_ghost where Amat was created via AZ_matrix_create(N_local); and a 'getrow' function was supplied via AZ_set_MATFREE_getrow(Amat,,,,N_ghost,).

Parameters
vecVector containing data. On output, ghost values are updated.
datapoints to user's data containing matrix values. and communication information.

Referenced by ML_Epetra::MultiLevelPreconditioner::ComputePreconditioner().

int ML_Epetra_getrow ( ML_Operator data,
int  N_requested_rows,
int  requested_rows[],
int  allocated_space,
int  columns[],
double  values[],
int  row_lengths[] 
)

Getrow function for matrix of type Epetra_RowMatrix.

Supply local matrix (without ghost node columns) for rows given by requested_rows[0 ... N_requested_rows-1]. Return this information in 'row_lengths, columns, values'. If there is not enough space to complete this operation, return 0. Otherwise, return 1.

Parameters
data(In) Points to user's data containing matrix values.
N_requested_rows(In) Number of rows for which nonzero are to be returned.
requested_rows(In) Requested_rows[0...N_requested_rows-1] give the row indices of the rows for which nonzero values are returned.
row_lengths(Out) Row_lengths[i] is the number of nonzeros in the row 'requested_rows[i]'
columns,values(Out) Columns[k] and values[k] contains the column number and value of a matrix nonzero where all nonzeros for requested_rows[i] appear before requested_rows[i+1]'s nonzeros. NOTE: Arrays are of size 'allocated_space'.
allocated_space(In) Indicates the space available in 'columns' and 'values' for storing nonzeros. If more space is needed, return 0.

Referenced by ML_Epetra::MultiLevelPreconditioner::ComputePreconditioner().

int ML_Epetra_matvec ( ML_Operator data,
int  in,
double *  p,
int  out,
double *  ap 
)

Matrix-vector function for Epetra matrices.

This is the ML matrix-vector wrap for Epetra matrices.

Referenced by ML_Epetra::MultiLevelPreconditioner::ComputePreconditioner().

int ML_Operator2EpetraCrsMatrix ( ML_Operator Ke,
Epetra_CrsMatrix *&  CrsMatrix,
int &  MaxNumNonzeros,
bool  CheckNonzeroRow,
double &  ,
int  base = 0,
bool  verbose = false 
)

Converts an ML_Operator into an Epetra_CrsMatrix.

This function creates a new Epetra_CrsMatrix, and inserts all the nonzero elements of the ML_Operator in it. This is an expensive conversion, in the sense that the Epetra_RowMatrix is a copy of the input ML_Operator.

Note
This function can be used with rectangular matrices.

Referenced by ML_Epetra::MultiLevelPreconditioner::MultiLevelPreconditioner().

int ML_Operator_WrapEpetraCrsMatrix ( Epetra_CrsMatrix A,
ML_Operator newMatrix,
bool  verbose = false 
)

Wraps an Epetra_CrsMatrix into an ML_Operator, for the given level.

This is an ultra cheap wrap in that I wrap the pointers that come out of Epetra's ExtractCrsDataPointers function.

You need to have remapped the Epetra Matrix to include all the columns before this routine gets called or else this won't work in parallel.

OptimizeStorage() must be called on the routines for the light wrap to be used. Otherwise, the routine calls ML_Operator_WrapEpetraMatrix as a fallback.

Note
ML requires A->RowMatrixRowMap() == A->OperatorRangeMap()
int ML_Operator_WrapEpetraMatrix ( Epetra_RowMatrix A,
ML_Operator Result 
)

Wraps an Epetra_RowMatrix into an ML_Operators, for the given level.

This function creates an ML_Operator that is based on the input Epetra_RowMatrix. This is a "cheap" wrap in the sense that only function and pointers are created. Data is still coded as an Epetra_RowMatrix. The ML_Operator is set in the specified level of the hierarchy.

Note
ML requires A->RowMatrixRowMap() == A->OperatorRangeMap()

Referenced by ML_Epetra::MultiLevelPreconditioner::ComputePreconditioner(), MLAPI::Operator::Reshape(), and MLAPI::LoadBalanceOperator::Reshape().