DIDASKO : Tutorial for Trilinos

TrilinosRelease5.0Branch

Table of Contents

• Introduction
• Amesos
• Anasazi Examples
• AztecOO Examples
• Epetra Examples
• EpetraExt Examples
• IFPACK Examples
• ML Examples
• NOX Examples
• TEUCHOS Examples
• Triutils Examples

Introduction

DIDASKO, the tutorial of Trilinos, offers a quick overview of Trilinos. The reader can find a variety of examples on several Trilinos packages. Each example is documented with comments and suggestions, some in the source file itself, and some others in the PDF document. The PDF version of the tutorial can be found in the Trilinos web page, or in file TRILINOS_HOME/packages/didasko/doc/tutorial.pdf.

Usually, a Trilinos package interoperates with other Trilinos packages (and with external packages as well). To be used efficiently, the examples of DIDASKO would require the following compilation flags:

--enable-epetra --enable-aztecoo --enable-amesos --enable-anasazi \
--enable-ifpack --enable-ml --enable-nox --enable-teuchos \
--enable-triutils

Most of the required packages are enabled by default. No example can effectively run without Epetra, and most require AztecOO and Triutils (this latter to generate the linear system matrix).

All the Didasko examples include, as first header file, the file

#include "Didasko_ConfigDefs.h"

Then, the code checks for installed libraries, like for instance

#if defined(HAVE_DIDASKO_EPETRA)

Note:

All the examples are compiled using autoconf and autotools. Each directory also contain a Makefile, called classicMakefile, which gives some suggestions about how to write a Makefile that does not depend on autotools.

In the following, we report the source code of each of the examples. Packages are reported in alphabetical order.

Amesos

• Basic usage of Amesos: amesos_ex1

Anasazi Examples

• Computation of the lowest eigenvalue and the corresponding eigenvector of a linear system: anasazi_ex1

Epetra Examples

• Basic usage of communicators: epetra_ex1
• Definition of Epetra_Map objects: epetra_ex2
• Definition of vectors: epetra_ex3
• Definition of serial dense vectors: epetra_ex4
• Basic operations on vectors. Work on the element vectors: epetra_ex5
• Use of ExtractView of Epetra_Vector: epetra_ex6
• Example of Epetra_MultiVector; use of ExtractView on MultiVector: epetra_ex7
• Epetra_Vectors in View mode; use of ResetView: epetra_ex8
• Epetra_Export classes: epetra_ex9
• Definition of dense serial matrices: epetra_ex10
• Basic definition of communicators: epetra_ex11
• Creation of a tridiagonal matrix: epetra_ex12
• Simple FE code: epetra_ex13
• Print out some information about an Epetra_CrsMatrix: epetra_ex14
• Output an Epetra_CrsMatrix in MATLAB format: epetra_ex15
• Output a vector in MATLAB format: epetra_ex16
• Construct an Epetra_VrbMatrix: epetra_ex17
• Basic operations on vectors: epetra_ex18
• Create an Epetra_CrsMatrix corresponding to a 2D Laplacian problem on a cartesian mesh: epetra_ex19
• Example of use of Epetra_Time and Epetra_Flops: epetra_ex20
• Use of Epetra_Operator: epetra_ex21, epetra_ex22
• Use of Epetra_FECrsMatrix: epetra_ex23
• Show the usage of RowMap, ColumnMap, RangeMap and DomainMap: epetra_ex24

EpetraExt Examples

• Generate a matrix using triutils and redistribute with Zoltan: epetraext_ex1
• Generate a linearproblem using triutils and redistribute with Zoltan: epetraext_ex2

AztecOO Examples

• Simple Jacobi preconditioner: aztecoo_ex1
• AztecOO as a preconditioner for AztecOO: aztecoo_ex2
• AztecOO CG and ICC(0) factorization as preconditioner: aztecoo_ex3

IFPACK Examples

• Using IFPACK factorizations as Aztec's preconditioners: ifpack_ex1, ifpack_ex2

ML Examples

• Two-level domain decomposition preconditioner with AztecOO and ML: ml_ex1
• Use of ML as a black-box smoothed aggregation preconditioner: ml_ex2

NOX Examples

• Simple nonlinear problem: nox_ex1
• Simple nonlinear PDE problem: nox_ex2

TEUCHOS Examples

• Teuchos dense matrices: teuchos_ex1
• Teuchos interface to BLAS: teuchos_ex2
• Teuchos interface to LAPACK: teuchos_ex3
• Teuchos parameters list: teuchos_ex4
• Teuchos RefCountPtr: teuchos_ex5
• Teuchos time monitor: teuchos_ex6
• Teuchos command line processor: teuchos_ex7

Triutils Examples

• Read a matrix in HB format: triutils_ex1
• Basic usage of CommandLineParser: triutils_ex2

---