all: $(example-doxygen) toc.html
-toc.html: steps.cmapx toc.html.in $D/examples/step-*/doc/tooltip
+toc-map.html: steps.cmapx toc-map.html.in
@echo ================== Making $@
- @perl make_toc.pl > toc.html
+ @perl make_toc.pl > toc-map.html
# generate dot file
steps.dot: steps.pl $D/examples/*/doc/tooltip
$/ = undef;
# Read source for web page
-open TOC, "<toc.html.in";
+open TOC, "<toc-map.html.in";
$toc = <TOC>;
close TOC;
<title>Step-by-Step Examples</title>
<link href="../../screen.css" rel="StyleSheet" type="text/css">
<meta name="author" content="the deal.II authors <authors@dealii.org>">
- <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2007, 2008, 2009 by the deal.II authors">
+ <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2007, 2008, 2009, 2010 by the deal.II authors">
<meta name="date" content="$Date$">
<meta name="svn_id" content="$Id$">
<meta name="keywords" content="deal.II,deal.II tutorial,deal II">
<p>
- <a href="toc.html#overview" target="body">Overview</a>
+ <a href="toc.html" target="body">Overview</a>
</p>
<p>
- <a href="toc.html#bynumber" target="body">Programs by number</a>
+ <a href="toc-map.html" target="body">Connections between programs</a>
</p>
<p>
- <a href="toc.html#bytopic" target="body">Programs by topic</a>
+ <a href="toc-list.html" target="body">Programs by number</a>
+ </p>
+ <p>
+ <a href="toc-topics.html" target="body">Programs by topic</a>
</p>
<hr>
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+"http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Step-by-Step</title>
+ <meta name="author" content="the deal.II authors <authors@dealii.org>">
+ <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2007, 2008, 2009, 2010 by the deal.II authors">
+ <meta name="date" content="$Date$">
+ <meta name="svn_id" content="$Id$">
+ <meta name="keywords" content="deal.II,deal.II tutorial,deal II">
+</head>
+
+<!-- Page Body -->
+<body lang="en">
+
+<h2>Tutorial programs listed by number</h2>
+
+<table align="center" width="80%">
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_1.html">Step-1</a></td>
+ <td> Creating a grid. A simple way to write it to a file.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_2.html">Step-2</a></td>
+ <td> Associate degrees of freedom to
+ each vertex and compute the resulting sparsity pattern of
+ matrices. Show that renumbering reduces the bandwidth of
+ matrices significantly, i.e. clusters nonzero entries around the
+ diagonal.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_3.html">Step-3</a></td>
+ <td> Actually solve Laplace's
+ problem. Object-orientation. Assembling matrices and
+ vectors. Boundary values.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_4.html">Step-4</a></td>
+ <td> This example is programmed in a
+ way that it is independent of the dimension for which we want to
+ solve Laplace's equation; we will solve the equation in 2D and
+ 3D, although the program is exactly the same. Non-constant right
+ hand side function. Non-homogeneous boundary values.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_5.html">Step-5</a></td>
+ <td> Computations on successively
+ refined grids. Reading a grid from disk. Some optimizations.
+ Using assertions. Non-constant coefficient in
+ the elliptic operator. Preconditioning the CG solver for the
+ linear system of equations.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_6.html">Step-6</a></td>
+ <td> Adaptive local
+ refinement. Handling of hanging nodes. Higher order elements.
+ Catching exceptions in the “main” function.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_7.html">Step-7</a></td>
+ <td> Helmholtz
+ equation. Non-homogeneous Neumann boundary conditions and
+ boundary integrals. Verification of correctness of computed
+ solutions. Computing the error between exact and numerical
+ solution and output of the data in tables. Using counted pointers.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_8.html">Step-8</a></td>
+ <td> The elasticity equations will be
+ solved instead of Laplace's equation. The solution is
+ vector-valued and the equations form a system with as many
+ equations as the dimension of the space in which it is posed.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_9.html">Step-9</a></td>
+ <td> Linear advection equation, assembling
+ the system of equations in parallel using multi-threading,
+ implementing a refinement criterion based on a finite difference
+ approximation of the gradient.
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_10.html">Step-10</a></td>
+ <td> Higher order mappings. Do not
+ solve equations, but rather compute the value of pi to high
+ accuracy.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_11.html">Step-11</a></td>
+ <td> Solving a Laplace problem with
+ higher order mappings. Using strange constraints and
+ intermediate representations of sparsity patterns.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_12.html">Step-12</a></td>
+ <td> Discontinuous Galerkin methods for linear advection problems.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_13.html">Step-13</a></td>
+ <td> Software design questions and
+ how to write a modular, extensible finite element program.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_14.html">Step-14</a></td>
+ <td> Duality based error estimators,
+ more strategies to write a modular, extensible finite element
+ program.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_15.html">Step-15</a></td>
+ <td> 1d problems, nonlinear solvers,
+ transfering a solution across mesh refinement.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_16.html">Step-16</a></td>
+ <td> Multigrid preconditioning of the Laplace equation on adaptive
+ meshes.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_17.html">Step-17</a></td>
+ <td> Using PETSc for linear algebra; running
+ in parallel on clusters of computers linked together by MPI.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_18.html">Step-18</a></td>
+ <td> A time dependent problem; using a much
+ simplified version of implementing elasticity; moving meshes; handling
+ large scale output of parallel programs.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_19.html">Step-19</a></td>
+ <td> Input parameter file handling. Merging
+ output of a parallel program.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_20.html">Step-20</a></td>
+ <td> Mixed finite elements. Using block
+ matrices and block vectors to define more complicated solvers and
+ preconditioners working on the Schur complement.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_21.html">Step-21</a></td>
+ <td> The time dependent two-phase flow in
+ porous media. Extensions of mixed Laplace discretizations. More
+ complicated block solvers. Simple time stepping.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_22.html">Step-22</a></td>
+ <td> Solving the Stokes equations of slow fluid flow on adaptive
+ meshes. More on Schur complement solvers. Advanced use of the
+ ConstraintMatrix class.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_23.html">Step-23</a></td>
+ <td> Finally a "real" time dependent problem, the wave equation.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_24.html">Step-24</a></td>
+ <td> A variant of step-23 with absorbing
+ boundary conditions, and extracting practically useful data.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_25.html">Step-25</a></td>
+ <td> The sine-Gordon
+ soliton equation, which is a nonlinear variant of the time
+ dependent wave equation covered in step-23 and step-24.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_27.html">Step-27</a></td>
+ <td> hp finite element methods </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_28.html">Step-28</a></td>
+ <td> Multiple grids for solving a multigroup diffusion equation
+ in nuclear physics simulating a nuclear reactor core </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_29.html">Step-29</a></td>
+ <td> Solving a complex-valued Helmholtz equation. Sparse direct
+ solvers. Dealing with parameter files. </td></tr>
+
+ <tr><td><a href="../../doxygen/deal.II/step_30.html">Step-30</a></td>
+ <td> Anisotropic refinement for DG finite element methods.
+ </td></tr>
+
+ <tr><td><a href="../../doxygen/deal.II/step_31.html">Step-31</a></td>
+ <td> Time-dependent Stokes flow driven by temperature
+ differences in a fluid. Adaptive meshes that change between time
+ steps.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_33.html">Step-33</a></td>
+ <td> A nonlinear hyperbolic conservation law: The Euler equations of
+ compressible gas dynamics.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_34.html">Step-34</a></td>
+ <td> Boundary element methods (BEM) of low order: Exterior irrotational
+ flow. The ParsedFunction class.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_35.html">Step-35</a></td>
+ <td> A projection solver for the Navier–Stokes equations.
+ </td></tr>
+
+ <tr valign="top">
+ <td><a href="../../doxygen/deal.II/step_36.html">Step-36</a></td>
+ <td> Using SLEPc for linear algebra; solving an eigenspectrum
+ problem. The Schrödinger wave equation.
+ </td></tr>
+</table>
+
+
+<!-- Page Foot -->
+<hr>
+<address>
+<a href="../../mail.html">The deal.II group</a></address>
+</body>
+</html>
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+"http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Step-by-Step</title>
+ <meta name="author" content="the deal.II authors <authors@dealii.org>">
+ <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2007, 2008, 2009, 2010 by the deal.II authors">
+ <meta name="date" content="$Date$">
+ <meta name="svn_id" content="$Id$">
+ <meta name="keywords" content="deal.II,deal.II tutorial,deal II">
+</head>
+
+<!-- Page Body -->
+<body lang="en">
+
+
+<h2>Map of tutorial programs</h2>
+
+The following graph shows the connections between tutorial programs.
+Click on any of the boxes to go to one of the programs. If you hover
+your mouse pointer over a box, a brief description of the program
+should appear.
+
+<img src="steps.png" usemap="#StepsMap"\/>
+@@MAP@@
+
+
+<!-- Page Foot -->
+<hr>
+<address>
+<a href="../../mail.html">The deal.II group</a></address>
+</body>
+</html>
<!-- Page Body -->
<body lang="en">
-<a name="overview"></a>
-<h2>Overview</h2>
-
-<p>
-The <acronym>deal.II</acronym> tutorial contains a collection of
-programs, each more
-or less built atop of previous ones, which demonstrate various
-aspects of the library. Each such example has the following structure
-follows:</p>
-<ol>
- <li> <b>Introduction:</b> A brief description of what the program does and
- what is new compared to the previous programs. This also includes a
- discussion of the mathematical model and its formulation.
- <li> <b>The commented program:</b> A listing of the program, interspersed
- with many comments that explain what is going on, how things are done
- and why.
- <li> <b>Results:</b> The output of the program, with some comments and
- interpretation.
- <li> <b>The plain program:</b> Since the program itself usually is a little
- bit unreadable with all the comments intertwingled, we present the
- program again, with all comments stripped off, to allow getting an
- overview of it.
-</ol>
-
-<p>
-The programs can be found at a path which is indicated at
-the beginning of the last section of each example. You can compile
-them by typing <strong>make</strong> in the respective directory, and run them
-using <strong>make run</strong>. The latter command also compiles the program
-if that has not already been done. The Makefiles in the different
-directories are based on the small program Makefile template described
-in <a href="../../development/index.html" target="_top">in this section</a>.
-</p>
-
-<p>
-Below we will list the currently available tutorial programs twice, once
-<a href="#bynumber">in numerical order explaining what is new in each
-program</a> and once <a href="#bytopic">listed by topic</a> to facilitate
-searching for programs with a certain functionality. Some of these programs
-also jointly form
-the <a href="../../doxygen/deal.II/group__geodynamics.html">geodynamics
- demonstration suite</a>.
-</p>
-
-
-<h2>Map of tutorial programs</h2>
-
-The following graph shows the connections between tutorial programs.
-Click on any of the boxes to go to one of the programs. If you hover
-your mouse pointer over a box, a brief description of the program
-should appear.
-
-<img src="steps.png" usemap="#StepsMap"\/>
-@@MAP@@
-
-<a name="bynumber"></a>
-<h2>Tutorial programs listed by number</h2>
-<table align="center" width="80%">
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_1.html">Step-1</a></td>
- <td> Creating a grid. A simple way to write it to a file.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_2.html">Step-2</a></td>
- <td> Associate degrees of freedom to
- each vertex and compute the resulting sparsity pattern of
- matrices. Show that renumbering reduces the bandwidth of
- matrices significantly, i.e. clusters nonzero entries around the
- diagonal.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_3.html">Step-3</a></td>
- <td> Actually solve Laplace's
- problem. Object-orientation. Assembling matrices and
- vectors. Boundary values.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_4.html">Step-4</a></td>
- <td> This example is programmed in a
- way that it is independent of the dimension for which we want to
- solve Laplace's equation; we will solve the equation in 2D and
- 3D, although the program is exactly the same. Non-constant right
- hand side function. Non-homogeneous boundary values.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_5.html">Step-5</a></td>
- <td> Computations on successively
- refined grids. Reading a grid from disk. Some optimizations.
- Using assertions. Non-constant coefficient in
- the elliptic operator. Preconditioning the CG solver for the
- linear system of equations.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_6.html">Step-6</a></td>
- <td> Adaptive local
- refinement. Handling of hanging nodes. Higher order elements.
- Catching exceptions in the “main” function.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_7.html">Step-7</a></td>
- <td> Helmholtz
- equation. Non-homogeneous Neumann boundary conditions and
- boundary integrals. Verification of correctness of computed
- solutions. Computing the error between exact and numerical
- solution and output of the data in tables. Using counted pointers.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_8.html">Step-8</a></td>
- <td> The elasticity equations will be
- solved instead of Laplace's equation. The solution is
- vector-valued and the equations form a system with as many
- equations as the dimension of the space in which it is posed.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_9.html">Step-9</a></td>
- <td> Linear advection equation, assembling
- the system of equations in parallel using multi-threading,
- implementing a refinement criterion based on a finite difference
- approximation of the gradient.
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_10.html">Step-10</a></td>
- <td> Higher order mappings. Do not
- solve equations, but rather compute the value of pi to high
- accuracy.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_11.html">Step-11</a></td>
- <td> Solving a Laplace problem with
- higher order mappings. Using strange constraints and
- intermediate representations of sparsity patterns.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_12.html">Step-12</a></td>
- <td> Discontinuous Galerkin methods for linear advection problems.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_13.html">Step-13</a></td>
- <td> Software design questions and
- how to write a modular, extensible finite element program.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_14.html">Step-14</a></td>
- <td> Duality based error estimators,
- more strategies to write a modular, extensible finite element
- program.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_15.html">Step-15</a></td>
- <td> 1d problems, nonlinear solvers,
- transfering a solution across mesh refinement.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_16.html">Step-16</a></td>
- <td> Multigrid preconditioning of the Laplace equation on adaptive
- meshes.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_17.html">Step-17</a></td>
- <td> Using PETSc for linear algebra; running
- in parallel on clusters of computers linked together by MPI.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_18.html">Step-18</a></td>
- <td> A time dependent problem; using a much
- simplified version of implementing elasticity; moving meshes; handling
- large scale output of parallel programs.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_19.html">Step-19</a></td>
- <td> Input parameter file handling. Merging
- output of a parallel program.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_20.html">Step-20</a></td>
- <td> Mixed finite elements. Using block
- matrices and block vectors to define more complicated solvers and
- preconditioners working on the Schur complement.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_21.html">Step-21</a></td>
- <td> The time dependent two-phase flow in
- porous media. Extensions of mixed Laplace discretizations. More
- complicated block solvers. Simple time stepping.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_22.html">Step-22</a></td>
- <td> Solving the Stokes equations of slow fluid flow on adaptive
- meshes. More on Schur complement solvers. Advanced use of the
- ConstraintMatrix class.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_23.html">Step-23</a></td>
- <td> Finally a "real" time dependent problem, the wave equation.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_24.html">Step-24</a></td>
- <td> A variant of step-23 with absorbing
- boundary conditions, and extracting practically useful data.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_25.html">Step-25</a></td>
- <td> The sine-Gordon
- soliton equation, which is a nonlinear variant of the time
- dependent wave equation covered in step-23 and step-24.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_27.html">Step-27</a></td>
- <td> hp finite element methods </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_28.html">Step-28</a></td>
- <td> Multiple grids for solving a multigroup diffusion equation
- in nuclear physics simulating a nuclear reactor core </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_29.html">Step-29</a></td>
- <td> Solving a complex-valued Helmholtz equation. Sparse direct
- solvers. Dealing with parameter files. </td></tr>
-
- <tr><td><a href="../../doxygen/deal.II/step_30.html">Step-30</a></td>
- <td> Anisotropic refinement for DG finite element methods.
- </td></tr>
-
- <tr><td><a href="../../doxygen/deal.II/step_31.html">Step-31</a></td>
- <td> Time-dependent Stokes flow driven by temperature
- differences in a fluid. Adaptive meshes that change between time
- steps.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_33.html">Step-33</a></td>
- <td> A nonlinear hyperbolic conservation law: The Euler equations of
- compressible gas dynamics.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_34.html">Step-34</a></td>
- <td> Boundary element methods (BEM) of low order: Exterior irrotational
- flow. The ParsedFunction class.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_35.html">Step-35</a></td>
- <td> A projection solver for the Navier–Stokes equations.
- </td></tr>
-
- <tr valign="top">
- <td><a href="../../doxygen/deal.II/step_36.html">Step-36</a></td>
- <td> Using SLEPc for linear algebra; solving an eigenspectrum
- problem. The Schrödinger wave equation.
- </td></tr>
-</table>
-
-
-<a name="bytopic"></a>
-<h2>Tutorial programs listed by topics</h2>
-
-The existing tutorial programs can be sorted into the following groups sorted
-by topic:
+<h2>Tutorial programs grouped by topics</h2>
<table align="center" width="80%">
<tr valign="top">
--- /dev/null
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+"http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Step-by-Step</title>
+ <meta name="author" content="the deal.II authors <authors@dealii.org>">
+ <meta name="copyright" content="Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2007, 2008, 2009, 2010 by the deal.II authors">
+ <meta name="date" content="$Date$">
+ <meta name="svn_id" content="$Id$">
+ <meta name="keywords" content="deal.II,deal.II tutorial,deal II">
+</head>
+
+<!-- Page Body -->
+<body lang="en">
+
+<a name="overview"></a>
+<h2>Overview</h2>
+
+<p>
+The <acronym>deal.II</acronym> tutorial contains a collection of
+programs, each more
+or less built atop of previous ones, which demonstrate various
+aspects of the library. Each such example has the following structure
+follows:</p>
+<ol>
+ <li> <b>Introduction:</b> A brief description of what the program does and
+ what is new compared to the previous programs. This also includes a
+ discussion of the mathematical model and its formulation.
+ <li> <b>The commented program:</b> A listing of the program, interspersed
+ with many comments that explain what is going on, how things are done
+ and why.
+ <li> <b>Results:</b> The output of the program, with some comments and
+ interpretation.
+ <li> <b>The plain program:</b> Since the program itself usually is a little
+ bit unreadable with all the comments intertwingled, we present the
+ program again, with all comments stripped off, to allow getting an
+ overview of it.
+</ol>
+
+<p>
+You can browse through the list of currently available tutorial programs in
+three different ways:
+<ul>
+ <li>In the <a href="toc-map.html">form of a graph</a> that shows how
+ tutorial programs build upon each other.
+
+ <li>In the <a href="toc-list.html">form of a list</a> that provides a short
+ synopsis of what each program does and which new concepts it introduces.
+
+ <li>In the <a href="toc-topics.html">form of groups of topics</a> such as
+ solvers or the kind of equations that different sets of tutorial program
+ address.
+</ul>
+Some of the programs also jointly form
+the <a href="../../doxygen/deal.II/group__geodynamics.html">geodynamics
+ demonstration suite</a>.
+</p>
+
+
+
+<h3>Usage</h3>
+
+<p>
+The programs are in the <code>examples/</code> directory of your local deal.II
+installation. If you go into one of the tutorial directories, you can compile
+the program by typing <strong>make</strong>, and run it
+using <strong>make run</strong>. The latter command also compiles the program
+if that has not already been done. The Makefiles in the different
+directories are based on the small program Makefile template described
+<a href="../../development/index.html" target="_top">in this section</a>.
+</p>
+
+
+
+<!-- Page Foot -->
+<hr>
+<address>
+<a href="../../mail.html">The deal.II group</a></address>
+</body>
+</html>