Trilinos/EpetraExt: Extensions to Epetra

TrilinosRelease4.0Branch

intro

EpetraExt is a set of extensions to Epetra. To allow Epetra to remain focused on it's primary functionality as a Linear Algebra object support, EpetraExt was created to maintain additional support for such capabilities as transformations (permutions, sub-block views, etc.), coloring support, partitioning (Zoltan), and I/O.

startup

formulations

EpetraExt contains a number of classes. They can be categorized as follows:

• EpetraExt::MatrixMatrix: Static Matrix Matrix Operations including Multiply and Add.

• Transforms: These classes derive from EpetraExt::Transform<T,U> allowing a common interface for transformation of epetra objects and migration of associated data.
  1. EpetraExt::Transform<T,U>: Abstract base for transformation of object of type T to object of type U.

  2. EpetraExt::Transform_Composite<T>: Allows the additive composition of EpetraExt::SameTypeTransform<T>'s.

  3. Convertors: EpetraExt::LinearProblem_GraphTrans and EpetraExt::LinearProblem_MatrixTrans converts a EpetraExt::SameTypeTransform<Epetra_CrsGraph> and EpetraExt::SameTypeTransform<Epetra_CrsMatrix> to a EpetraExt::SameTypeTransform<Epetra_LinearProblem>

  4. EpetraExt::CrsGraph_Overlap: Forms the overlapped version of a distributed graph up to the user specified level.

  5. Reindexer's: Used to remap the global indexing of an existing Epetra object include EpetraExt::CrsMatrix_Reindex, EpetraExt::MultiVector_Reindex, and EpetraExt::LinearProblem_Reindex.

  6. EpetraExt::LinearProblem_Scale: Linear left and right scaling of a Epetra_LinearProblem

  7. Solver Mapping Tools: Remaps the columns of a CrsGraph or LinearProblem to meet the requirements of a square local block indexing for some linear solvers. Tools are EpetraExt::CrsGraph_SolverMap and EpetraExt::LinearProblem_SolverMap.

  8. EpetraExt::CrsGraph_SymmRCM: Perform a symmetric RCM for the local blocks of a Epetra_CrsGraph.

  9. Transpose: Form the explicit transpose of a Epetra_CrsGraph or Epetra_CrsMatrix. Tools are EpetraExt::CrsGraph_Transpose and EpetraExt::RowMatrix_Transpose.

  10. View: For sub-block views of existing Epetra objects including EpetraExt::CrsGraph_View, EpetraExt::CrsMatrix_View and EpetraExt::MultiVector_View

• InOut: I/O operations for Epetra objects based on the Matrix Market format.

• Coloring: Helper tools for generating Finite Differencing Colorings of Linear Problems.

• Zoltan Tools: Primarily tools for generation of repartitioned Epetra objects using the Zoltan library..

---