From: Wolfgang Bangerth Date: Mon, 25 Aug 2014 00:11:30 +0000 (-0500) Subject: Provide a link to the manifold documentation module. X-Git-Tag: v8.2.0-rc1~179^2~1 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fa77ad69b659f3c132718cef1b87a18a74d953f9;p=dealii.git Provide a link to the manifold documentation module. Also provide more discussion and fix a number of oversights in the current version of the documentation. --- diff --git a/include/deal.II/grid/grid_generator.h b/include/deal.II/grid/grid_generator.h index 14ea1a5924..49ee2e83a5 100644 --- a/include/deal.II/grid/grid_generator.h +++ b/include/deal.II/grid/grid_generator.h @@ -453,10 +453,10 @@ namespace GridGenerator * is zero (as is the default), then it is computed adaptively such that the * resulting elements have the least aspect ratio. * - * In 3d, only two different numbers are meaningful, 6 for a surface based + * In 3d, only certain numbers are allowed, 6 for a surface based * on a hexahedron (i.e. 6 panels on the inner sphere extruded in radial - * direction to form 6 cells) and 12 for the rhombic dodecahedron. These - * give rise to the following meshes upon one refinement: + * direction to form 6 cells), 12 for the rhombic dodecahedron, and 96 (see + * below). These give rise to the following meshes upon one refinement: * * @image html hypershell3d-6.png * @image html hypershell3d-12.png @@ -467,7 +467,7 @@ namespace GridGenerator * * @image html hyper_shell_6_cross_plane.png * - * The mesh generated with n_cells=6 is better but still not + * The mesh generated with n_cells=12 is better but still not * good. As a consequence, you may also specify n_cells=96 as a * third option. The mesh generated in this way is based on a once refined * version of the one with n_cells=12, where all internal nodes @@ -480,6 +480,13 @@ namespace GridGenerator * @image html hyper_shell_12_cut.png * @image html hyper_shell_96_cut.png * + * A different way to approach the problem with distorted cells + * is to attach appropriate manifold descriptions to the geometry created + * by this function. In the current context, this would involve the + * SphericalManifold class. An example of how this works and what it leads + * to is shown in the documentation of the + * @ref manifold "documentation module on manifolds". + * * @note This function is declared to exist for triangulations of all space * dimensions, but throws an error if called in 1d. *