From cb09cf6dcd813bea189a1ed83a332be90a50ea93 Mon Sep 17 00:00:00 2001 From: bangerth Date: Wed, 9 Jul 2014 17:10:31 +0000 Subject: [PATCH] Minor edits. git-svn-id: https://svn.dealii.org/branches/branch_manifold_id_intermediate@33127 0785d39b-7218-0410-832d-ea1e28bc413d --- deal.II/doc/doxygen/headers/manifold.h | 58 ++++++++++++++------------ 1 file changed, 32 insertions(+), 26 deletions(-) diff --git a/deal.II/doc/doxygen/headers/manifold.h b/deal.II/doc/doxygen/headers/manifold.h index f03fd15208..ac21c54520 100644 --- a/deal.II/doc/doxygen/headers/manifold.h +++ b/deal.II/doc/doxygen/headers/manifold.h @@ -1,7 +1,7 @@ // --------------------------------------------------------------------- // $Id: manifold.h 30130 2013-07-23 13:01:18Z heltai $ // -// Copyright (C) 2003 - 2013 by the deal.II authors +// Copyright (C) 2003 - 2014 by the deal.II authors // // This file is part of the deal.II library. // @@ -16,34 +16,37 @@ /** - * @defgroup manifold Boundary description for triangulations + * @defgroup manifold Manifold description for triangulations * * The classes in this module are concerned with the description of the - * manifold of a domain in which a Triangulation lives. This manifold - * description is necessary in two contexts: + * manifold in which the domain that a Triangulation describes lives. This + * manifold description is necessary in two contexts: + * * * - * In deal.II, a Manifold is seen as a collection of points, together - * with a notion of distance between points (on the manifold). New - * points are obtained by providing a local coordinate system on the - * manifold, identifying existing points in the local coordinate - * system (pulling them back using the local map to obtain their local - * coordinates), find the new point in the local coordinate system by - * weighted sums of the existing points, and transforming back the - * point in the real space (pushing it forward using the local map). + * In deal.II, a Manifold is seen as a collection of points, together with a + * notion of distance between points (on the manifold). New points are + * typically obtained by providing a local coordinate system on the manifold, + * identifying existing points in the local coordinate system (pulling them + * back using the local map to obtain their local coordinates), find the new + * point in the local coordinate system by weighted sums of the existing + * points, and transforming back the point in the real space (pushing it + * forward using the local map). (However, this pull back and push forward + * only happens in classes that implement manifolds, and your own class can + * also choose other ways of figuring out where a new point should be + * located.) * * While this process is non trivial in most cases of interest, for * most of the trivial geometries, like cylinders, spheres or shells, -- 2.39.5