From 4f9d30efdf52cc0e1a329f592847e7da053eb96c Mon Sep 17 00:00:00 2001 From: Guido Kanschat Date: Tue, 12 Jul 2005 22:00:41 +0000 Subject: [PATCH] minor improvements on last changes git-svn-id: https://svn.dealii.org/trunk@11127 0785d39b-7218-0410-832d-ea1e28bc413d --- deal.II/doc/doxygen/headers/deal.II/dox.h | 7 ++- .../doc/doxygen/headers/deal.II/glossary.h | 58 ++++++++++++++++++- .../doc/doxygen/headers/deal.II/iterators.h | 23 ++++++-- 3 files changed, 82 insertions(+), 6 deletions(-) diff --git a/deal.II/doc/doxygen/headers/deal.II/dox.h b/deal.II/doc/doxygen/headers/deal.II/dox.h index dcd09fdc13..20d5c8a416 100644 --- a/deal.II/doc/doxygen/headers/deal.II/dox.h +++ b/deal.II/doc/doxygen/headers/deal.II/dox.h @@ -12,7 +12,7 @@ //------------------------------------------------------------------------- /** - * @defgroup grid Grids + * @defgroup grid Grid Classes */ /** @@ -21,6 +21,11 @@ /** * @defgroup feall Finite Elements + * + * All classes related to shape functions and to access to shape + * functions. This concerns the actual values of finite elements. For + * the numbering of degrees of freedom refer to @ref dofs. + * * @{ */ /** diff --git a/deal.II/doc/doxygen/headers/deal.II/glossary.h b/deal.II/doc/doxygen/headers/deal.II/glossary.h index 921c87687b..9bb457659f 100644 --- a/deal.II/doc/doxygen/headers/deal.II/glossary.h +++ b/deal.II/doc/doxygen/headers/deal.II/glossary.h @@ -3,8 +3,64 @@ * *
* - *
@anchor GlossActive active cells
+ *
@anchor GlossActive Active cells
*
Mesh cells not refined any further in the hierarchy.
* + *
@anchor GlossGeneralizedSupport Generalized support points
+ *
While @ref GlossSupport "support points" allow very simple interpolation + * into the finite element space, their concept is restricted to + * @ref GlossLagrange "Lagrange elements". For other elements, more general + * interpolation operators can be defined, often relying on integral values + * or moments. Since these integral values are again computed using a + * Quadrature rule, we consider them a generalization of support + * points. + * + * Note that there is no simple relation between + * @ref GlossShape "shape functions" and generalized support points as for + * regular @ref GlossSupport "support points". Instead, FiniteElement defines + * a couple of interpolation functions doing the actual interpolation. + * + * @note If a finite element is Lagrangian, generalized support points + * and support points coincide. + * + *
+ * + *
@anchor GlossLagrange Lagrange elements
+ *
Finite elements based on Lagrangian interpolation at + * @ref GlossSupport "support points".
+ * + *
@anchor GlossReferenceCell Reference cell
+ *
The hypercube [0,1]dim, on which all parametric finite + * element shape functions are defined.
+ * + *
@anchor GlossSupport Support points
+ *
Support points are by definition those points pi, + * such that for the shape functions vj holds + * vj(pi) = δij. Therefore, a + * finite element interpolation can be defined uniquely by the values in the + * support points. + * + * Lagrangian elements fill the vector accessed by + * FiniteElementBase::get_unit_support_points(), such that the + * function FiniteElementBase::has_support_points() returns + * true. Naturally, these support points are on the + * @ref GlossReferenceCell "reference cell". Then, FEValues can be used + * (in conjuncton with a Mapping) to access support points on the + * actual grid cells. + * + * @note The concept of @ref GlossSupport "support points" is + * restricted to the finite element families based on Lagrange + * interpolation. For a more general concept, see + * @ref GlossGeneralizedSupport "generalized support points". + *
+ * + *
@anchor GlossUnitCell Unit cell
+ *
See @ref GlossReferenceCell "Reference cell".
+ * + *
@anchor GlossUnitSupport Unit support points
+ *
@ref GlossSupport "Support points" on the reference cell, defined in + * FiniteElementBase. + *
+ * *
*/ diff --git a/deal.II/doc/doxygen/headers/deal.II/iterators.h b/deal.II/doc/doxygen/headers/deal.II/iterators.h index 6d6e387f68..9fea967019 100644 --- a/deal.II/doc/doxygen/headers/deal.II/iterators.h +++ b/deal.II/doc/doxygen/headers/deal.II/iterators.h @@ -1,5 +1,5 @@ /** -@page Iterators Iterators on mesh like containers + @defgroup Iterators Iterators on mesh like containers deal.II has several classes which are understood conceptionally as meshes. Apart from the obvious Triangulation, these are DoFHandler and @@ -58,10 +58,10 @@ distinction is only in the Accessor. The standard loops are
-
TriaIterator +
TriaIterator
Traverse all cells on all levels
-
TriaActiveIterator +
TriaActiveIterator
Loop over @ref GlossActive "active cells" only
@@ -73,7 +73,6 @@ is determined by the Accessor. The magic is, that for any iterator i, the term i-> grants access to all attributes of this Accessor. - @section IteratorsTypedefs Iterators defined in the containers The standard iterators are typedefed inside the classes. These are @@ -82,4 +81,20 @@ The standard iterators are typedefed inside the classes. These are cell_iterator face_iterator + + +Triangulation +TriaIterator<dim, CellAccessor<dim> > +TriaIterator<dim, TriaObjectAccessor<dim-1, dim> > + + +DoFHandler +TriaIterator<dim, DoFCellAccessor<dim> > +TriaIterator<dim, DoFObjectAccessor<dim-1, dim> > + + +@section IteratorsFiltered Filtered iterators +... +*/ + -- 2.39.5