From: wolf
Date: Tue, 28 Mar 2006 06:15:27 +0000 (+0000)
Subject: More doxygenization work
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=11938436b910bdd8cf6635acd09197b1f3ce5216;p=dealii-svn.git
More doxygenization work
git-svn-id: https://svn.dealii.org/trunk@12708 0785d39b-7218-0410-832d-ea1e28bc413d
---
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q1_ref0.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q1_ref0.jpg
deleted file mode 100644
index f03629236d..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q1_ref0.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q1_ref1.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q1_ref1.jpg
deleted file mode 100644
index 70029f7281..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q1_ref1.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q2_ref0.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q2_ref0.jpg
deleted file mode 100644
index fe7c9b6916..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q2_ref0.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q2_ref1.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q2_ref1.jpg
deleted file mode 100644
index d3a8110f11..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q2_ref1.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q3_ref0.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q3_ref0.jpg
deleted file mode 100644
index 2652050a28..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q3_ref0.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q3_ref1.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q3_ref1.jpg
deleted file mode 100644
index 7f4494c077..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/ball_mapping_q3_ref1.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/intro.html b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/intro.dox
similarity index 79%
rename from deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/intro.html
rename to deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/intro.dox
index 7cc6081ef1..2749945848 100644
--- a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/intro.html
+++ b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/intro.dox
@@ -1,9 +1,9 @@
Introduction
-
+
This is a rather short example which only shows some aspects of using
-higher order mappings. By mapping we mean the transformation
+higher order mappings. By mapping we mean the transformation
between the unit cell (i.e. the unit line, square, or cube) to the
cells in real space. In all the previous examples, we have implicitly
used linear or d-linear mappings; you will not have noticed this at
@@ -14,16 +14,16 @@ cases where the piecewise linear approximation of the boundary
your computational domain is an approximation to the real domain using
curved boundaries as well. If the boundary approximation uses
piecewise quadratic parabolas to approximate the true boundary, then
-we say that this is a quadratic or Q2 approximation. If we
-use piecewise graphs of cubic polynomials, then this is a Q3
+we say that this is a quadratic or $Q_2$ approximation. If we
+use piecewise graphs of cubic polynomials, then this is a $Q_3$
approximation, and so on.
-
-
+
+
For some differential equations, it is known that piecewise linear
-approximations of the boundary, i.e. Q1 mappings, are not
+approximations of the boundary, i.e. $Q_1$ mappings, are not
sufficient if the boundary of the domain is curved. Examples are the
-biharmonic equation using C1 elements, or the Euler
+biharmonic equation using $C^1$ elements, or the Euler
equation on domains with curved reflective boundaries. In these cases,
it is necessary to compute the integrals using a higher order
mapping. The reason, of course, is that if we do not use a higher
@@ -31,31 +31,31 @@ order mapping, the order of approximation of the boundary dominates
the order of convergence of the entire numerical scheme, irrespective
of the order of convergence of the discretization in the interior of
the domain.
-
-
+
+
Rather than demonstrating the use of higher order mappings with one of
these more complicated examples, we do only a brief computation:
-calculating the value of pi=3.141592653589793238462643... by two
+calculating the value of $\pi=3.141592653589793238462643\ldots$ by two
different methods.
-
-
+
+
The first method uses a triangulated approximation of the circle with
unit radius and integrates the unit function over it. Of course, if
the domain were the exact unit circle, then the area would be pi, but
since we only use an approximation by piecewise polynomial segments,
the value of the area is not exactly pi. However, it is known that as
-we refine the triangulation, a Qp mapping approximates the boundary
-with an order hp+1, where h is the mesh
+we refine the triangulation, a $Q_p$ mapping approximates the boundary
+with an order $h^{p+1}$, where $h$ is the mesh
width. We will check the values of the computed area of the circle and
their convergence towards pi under mesh refinement for different
mappings. We will also find a convergence behavior that is surprising
at first, but has a good explanation.
-
-
+
+
The second method works similarly, but this time does not use the area
of the triangulated unit circle, but rather its perimeter. Pi is then
approximated by half of the perimeter, as the radius is equal to one.
-
+
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/quarter-q1.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/quarter-q1.jpg
deleted file mode 100644
index 1a48333ca7..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/quarter-q1.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/quarter-q2.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/quarter-q2.jpg
deleted file mode 100644
index 48989bd740..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/quarter-q2.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/quarter-q3.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/quarter-q3.jpg
deleted file mode 100644
index 63e22dc451..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/quarter-q3.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/results.html b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/results.dox
similarity index 78%
rename from deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/results.html
rename to deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/results.dox
index 4fc34ce541..cccf2683e5 100644
--- a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/results.html
+++ b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/results.dox
@@ -1,27 +1,27 @@
Results
-
+
The program performs two tasks, the first being to generate a
visualization of the mapped domain, the second to compute pi by the
two methods described. Let us first take a look at the generated
graphics. They are generated in Gnuplot format, and can be viewed with
the commands
-
+@code
set data style lines
set size 0.721, 1
set nokey
plot [-1:1][-1:1] "ball0_mapping_q1.dat"
-
+@endcode
or using one of the other filenames. The second line makes sure that
the aspect ratio of the generated output is actually 1:1, i.e. a
circle is drawn as a circle on your screen, rather than as an
ellipse. The third line switches off the key in the graphic, as that
will only print information (the filename) which is not that important
right now.
-
-
+
+
The following table shows the triangulated computational domain for
Q1, Q2, and Q3 mappings, for the original coarse grid (left), and a
once uniformly refined grid (right). If your browser does not display
@@ -29,28 +29,28 @@ these pictures in acceptable quality, view them one by one.
-
+ @image html step-10.ball_mapping_q1_ref0.png
|
-
+ @image html step-10.ball_mapping_q1_ref1.png
|
-
+ @image html step-10.ball_mapping_q2_ref0.png
|
-
+ @image html step-10.ball_mapping_q2_ref1.png
|
-
+ @image html step-10.ball_mapping_q3_ref0.png
|
-
+ @image html step-10.ball_mapping_q3_ref1.png
|
@@ -62,13 +62,13 @@ with dashed lines the exact circle:
-
+ @image html step-10.quarter-q1.png
|
-
+ @image html step-10.quarter-q2.png
|
-
+ @image html step-10.quarter-q3.png
|
@@ -82,12 +82,12 @@ only on cells at the boundary. Higher order mappings are therefore
usually not noticably slower than lower order ones, because the
additional computations are only performed on a small subset of all
cells.
-
-
+
+
The second purpose of the program was to compute the value of pi to
good accuracy. This is the output of this part of the program:
-
+@code
Computation of Pi by the area:
==============================
Degree = 1
@@ -164,31 +164,31 @@ cells eval.pi error
320 3.1415926540544636 4.6467e-10 6.00
1280 3.1415926535970535 7.2602e-12 6.00
5120 3.1415926535899010 1.0805e-13 6.07
-
-
+@endcode
+
+
-
One of the immediate observations from the output is that in all cases
the values converge quickly to the true value of
-pi=3.141592653589793238462643. Note that for the Q4 mapping, the last
+$\pi=3.141592653589793238462643$. Note that for the $Q_4$ mapping, the last
number is correct to 13 digits in both computations, which is already
-quite a lot. However, also note that for the Q1 mapping, even on the
+quite a lot. However, also note that for the $Q_1$ mapping, even on the
finest grid the accuracy is significantly worse than on the coarse
-grid for a Q4 mapping!
-
+grid for a $Q_4$ mapping!
+
+
-
The last column of the output shows the convergence order, in powers
-of the mesh width h. In the introduction, we had stated that
-the convergence order for a Qp mapping should be
-hp+1. However, in the example shown, the Q2 and Q4
-mappings show a convergence order of hp+2! This at
+of the mesh width $h$. In the introduction, we had stated that
+the convergence order for a $Q_p$ mapping should be
+$h^{p+1}$. However, in the example shown, the $Q_2$ and $Q_4$
+mappings show a convergence order of $h^{p+2}$! This at
first surprising fact is readily explained by the particular boundary
we have chosen in this example. In fact, the circle is described by the function
-sqrt(1-x2), which has the series expansion
-1-x2/2-x4/8-x6/16+...
-around x=0. Thus, for the quadratic mapping where the
+$\sqrt{1-x^2}$, which has the series expansion
+$1-x^2/2-x^4/8-x^6/16+\ldots$
+around $x=0$. Thus, for the quadratic mapping where the
truncation error of the quadratic approximation should be cubic, there
is no such term but only a quartic one, which raises the convergence
-order to 4, instead of 3. The same happens for the Q4 mapping.
-
+order to 4, instead of 3. The same happens for the $Q_4$ mapping.
+
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q1_ref0.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q1_ref0.png
new file mode 100644
index 0000000000..37bfb6874e
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q1_ref0.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q1_ref1.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q1_ref1.png
new file mode 100644
index 0000000000..132fe88a86
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q1_ref1.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q2_ref0.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q2_ref0.png
new file mode 100644
index 0000000000..c46928c40d
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q2_ref0.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q2_ref1.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q2_ref1.png
new file mode 100644
index 0000000000..34287d0f18
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q2_ref1.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q3_ref0.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q3_ref0.png
new file mode 100644
index 0000000000..8b28048d77
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q3_ref0.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q3_ref1.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q3_ref1.png
new file mode 100644
index 0000000000..4de02299bc
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.ball_mapping_q3_ref1.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.quarter-q1.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.quarter-q1.png
new file mode 100644
index 0000000000..c41bd99f2c
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.quarter-q1.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.quarter-q2.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.quarter-q2.png
new file mode 100644
index 0000000000..b72444ed26
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.quarter-q2.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.quarter-q3.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.quarter-q3.png
new file mode 100644
index 0000000000..013117e68f
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-10.data/step-10.quarter-q3.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/grid-5.gif b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/grid-5.gif
deleted file mode 100644
index 82dedab4f6..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/grid-5.gif and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/results.html b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/results.dox
similarity index 60%
rename from deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/results.html
rename to deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/results.dox
index 77e28becba..65b91e3181 100644
--- a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/results.html
+++ b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/results.dox
@@ -1,19 +1,18 @@
Results
-
+
The output of this program consist of the console output, the eps
files including the grids, and the solutions given in gnuplot format.
-
-
+@code
Cycle 0:
Number of active cells: 64
Number of degrees of freedom: 256
Time of assemble_system1: 0.05
Time of assemble_system2: 0.04
solution1 and solution2 coincide.
-Writing grid to <grid-0.eps>...
-Writing solution to <sol-0.gnuplot>...
+Writing grid to ...
+Writing solution to ...
Cycle 1:
Number of active cells: 112
@@ -21,8 +20,8 @@ Cycle 1:
Time of assemble_system1: 0.09
Time of assemble_system2: 0.07
solution1 and solution2 coincide.
-Writing grid to <grid-1.eps>...
-Writing solution to <sol-1.gnuplot>...
+Writing grid to ...
+Writing solution to ...
Cycle 2:
Number of active cells: 214
@@ -30,8 +29,8 @@ Cycle 2:
Time of assemble_system1: 0.17
Time of assemble_system2: 0.14
solution1 and solution2 coincide.
-Writing grid to <grid-2.eps>...
-Writing solution to <sol-2.gnuplot>...
+Writing grid to ...
+Writing solution to ...
Cycle 3:
Number of active cells: 415
@@ -39,8 +38,8 @@ Cycle 3:
Time of assemble_system1: 0.32
Time of assemble_system2: 0.28
solution1 and solution2 coincide.
-Writing grid to <grid-3.eps>...
-Writing solution to <sol-3.gnuplot>...
+Writing grid to ...
+Writing solution to ...
Cycle 4:
Number of active cells: 796
@@ -48,8 +47,8 @@ Cycle 4:
Time of assemble_system1: 0.62
Time of assemble_system2: 0.52
solution1 and solution2 coincide.
-Writing grid to <grid-4.eps>...
-Writing solution to <sol-4.gnuplot>...
+Writing grid to ...
+Writing solution to ...
Cycle 5:
Number of active cells: 1561
@@ -57,35 +56,34 @@ Cycle 5:
Time of assemble_system1: 1.23
Time of assemble_system2: 1.03
solution1 and solution2 coincide.
-Writing grid to <grid-5.eps>...
-Writing solution to <sol-5.gnuplot>...
+Writing grid to ...
+Writing solution to ...
+@endcode
-
-
We see that, as expected, on each refinement step the two solutions
coincide. The difference measured in time of treating each face only
once (second version of the DG method) in comparison with treating
each face twice within a nested loop over all cells and all faces of
each cell (first version), is much less than one might have
expected. The gain is less than 20% on the last few refinement steps.
-
- First we show the solutions on the initial mesh, the mesh after two
+
+ First we show the solutions on the initial mesh, the mesh after two
and after five adaptive refinement steps.
-
-
-
-
-
- Then we show the final grid (after 5 refinement steps). The
+@image step-12.sol-0.png
+@image step-12.sol-2.png
+@image step-12.sol-5.png
+
+
+Then we show the final grid (after 5 refinement steps). The
grid is largely concentrated in the vicinity of the jump of the
solution.
-
-
-
-
- And finally we show a plot of a 3d computation.
-
-
-
+
+@image step-12.grid-5.png
+
+
+And finally we show a plot of a 3d computation.
+
+@image html step-12.sol-5-3d.png
+
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-0.gif b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-0.gif
deleted file mode 100644
index d4d0b52469..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-0.gif and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-2.gif b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-2.gif
deleted file mode 100644
index 175c9c99b5..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-2.gif and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-5-3d.gif b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-5-3d.gif
deleted file mode 100644
index 1899455ffc..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-5-3d.gif and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-5.gif b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-5.gif
deleted file mode 100644
index e57bc0572e..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/sol-5.gif and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.grid-5.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.grid-5.png
new file mode 100644
index 0000000000..a2383b9551
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.grid-5.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-0.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-0.png
new file mode 100644
index 0000000000..16ae3fb90f
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-0.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-2.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-2.png
new file mode 100644
index 0000000000..081f3afc8b
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-2.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-5-3d.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-5-3d.png
new file mode 100644
index 0000000000..6f80120c9b
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-5-3d.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-5.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-5.png
new file mode 100644
index 0000000000..d9cfd871fb
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-12.data/step-12.sol-5.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-16.data/intro.html b/deal.II/doc/tutorial/chapter-2.step-by-step/step-16.data/intro.dox
similarity index 81%
rename from deal.II/doc/tutorial/chapter-2.step-by-step/step-16.data/intro.html
rename to deal.II/doc/tutorial/chapter-2.step-by-step/step-16.data/intro.dox
index 2d78fbf791..750048aaef 100644
--- a/deal.II/doc/tutorial/chapter-2.step-by-step/step-16.data/intro.html
+++ b/deal.II/doc/tutorial/chapter-2.step-by-step/step-16.data/intro.dox
@@ -1,15 +1,15 @@
Introduction
-
+
This example shows the basic usage of the multilevel functions in
-deal.II. It solves the Helmholtz equation with Neumann boundary conditions
+deal.II. It solves the Helmholtz equation with Neumann boundary conditions
to avoid additional complications due to Dirichlet boundary conditions (there,
some library functions are missing). Therefore, the solution is the constant
function with value unity. In all other respects, it is similar to step 5.
-
- In order to allow sufficient flexibility in conjunction with systems of
+
+ In order to allow sufficient flexibility in conjunction with systems of
differential equations and block preconditioners, quite a few different objects
have to be created before starting the multilevel method. These are
@@ -19,17 +19,17 @@ have to be created before starting the multilevel method. These are
- MGMatrix, the matrix object having a special level multiplication, i.e. we
basically store one matrix per grid level and allow multiplication with it.
-
-
+
+
These objects are combined in an object of type Multigrid, containing the
implementation of the V-cycle, which is in turn used by the preconditioner
PreconditionMG, ready for plug-in into a linear solver of the LAC library.
-
-
-The multilevel method in deal.II follows in many respects the outlines
+
+
+The multilevel method in deal.II follows in many respects the outlines
of the various publications by James Bramble, Joseph Pasciak and Jinchao Xu. In
order to understand many of the options, a rough familiarity with their work is
quite helpful.
-
+
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-16.data/results.html b/deal.II/doc/tutorial/chapter-2.step-by-step/step-16.data/results.dox
similarity index 100%
rename from deal.II/doc/tutorial/chapter-2.step-by-step/step-16.data/results.html
rename to deal.II/doc/tutorial/chapter-2.step-by-step/step-16.data/results.dox
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/displacement-vectors.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/displacement-vectors.jpg
deleted file mode 100644
index e32ec8c20f..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/displacement-vectors.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/displacement-x.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/displacement-x.jpg
deleted file mode 100644
index 306bc68dde..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/displacement-x.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/displacement-y.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/displacement-y.jpg
deleted file mode 100644
index 3028b9f6e9..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/displacement-y.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/final-grid.jpg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/final-grid.jpg
deleted file mode 100644
index 2fbccd2521..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/final-grid.jpg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/results.html b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/results.dox
similarity index 70%
rename from deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/results.html
rename to deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/results.dox
index 9f7c98cdf3..bc6a11423e 100644
--- a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/results.html
+++ b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/results.dox
@@ -1,50 +1,47 @@
Results
-
+
There is not much to be said about the results of this program, apart
from that they look nice. All images were made using GMV from the
output files that the program wrote to disk. The first picture shows
the displacement as a vector field, where one vector is shown at each
vertex of the grid:
-
-
-
-
-
+@image html step-8.vectors.png
+
+
You can clearly see the sources of x-displacement around x=0.5 and
x=-0.5, and of y-displacement at the origin. The next image shows the
final grid after eight steps of refinement:
-
-
-
-
-
+@image html step-8.grid.png
+
+
+
Finally, the x-displacement and y-displacement are displayed separately:
-
-
+
+
-
+@image html step-8.x.png
|
-
+@image html step-8.y.png
|
-
-
+
+
It should be noted that intuitively one would have expected the
solution to be symmetric about the x- and y-axes since the x- and
y-forces are symmetric with respect to these axes. However, the force
considered as a vector is not symmetric and consequently neither is
the solution.
-
+
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.grid.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.grid.png
new file mode 100644
index 0000000000..8dbd79f5fc
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.grid.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.vectors.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.vectors.png
new file mode 100644
index 0000000000..ff7f082fe9
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.vectors.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.x.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.x.png
new file mode 100644
index 0000000000..d961789ac4
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.x.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.y.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.y.png
new file mode 100644
index 0000000000..9ae4f77872
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-8.data/step-8.y.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/final-grid.gif b/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/final-grid.gif
deleted file mode 100644
index d468124836..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/final-grid.gif and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/final-solution.jpeg b/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/final-solution.jpeg
deleted file mode 100644
index e891149bae..0000000000
Binary files a/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/final-solution.jpeg and /dev/null differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/results.html b/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/results.dox
similarity index 84%
rename from deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/results.html
rename to deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/results.dox
index eace7e86f0..0217858a78 100644
--- a/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/results.html
+++ b/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/results.dox
@@ -1,12 +1,11 @@
Results
-
+
The results of this program are not particularly spectacular. They
consist of the console output, some grid files, and the solution on
the finest grid. First for the console output:
-
-
+@code
Cycle 0:
Number of active cells: 256
Number of degrees of freedom: 289
@@ -25,31 +24,27 @@ Cycle 4:
Cycle 5:
Number of active cells: 26002
Number of degrees of freedom: 30035
-
-
+@endcode
As can be seen, quite a number of cells is used on the finest level to
resolve the features of the solution. The final grid showing this is
displayed in the following picture:
-
-
-
-
-
+@image html step-9.grid.png
+
+
+
The structure of the grid will be understandable by looking at the
solution itself:
-
-
-
-
-
+@image html step-9.solution.png
+
+
+
Note that the solution is created by that part that is transported
along the wiggled advection field from the left and lower boundaries
to the top right, and the part that is created by the source in the
lower left corner, and the results of which are also transported
along. The grid shown above is well-adapted to resolve these
features.
-
\ No newline at end of file
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/step-9.grid.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/step-9.grid.png
new file mode 100644
index 0000000000..2c28509099
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/step-9.grid.png differ
diff --git a/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/step-9.solution.png b/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/step-9.solution.png
new file mode 100644
index 0000000000..e5164f3f50
Binary files /dev/null and b/deal.II/doc/tutorial/chapter-2.step-by-step/step-9.data/step-9.solution.png differ