From fa77ad69b659f3c132718cef1b87a18a74d953f9 Mon Sep 17 00:00:00 2001 From: Wolfgang Bangerth Date: Sun, 24 Aug 2014 19:11:30 -0500 Subject: [PATCH] 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. --- include/deal.II/grid/grid_generator.h | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) 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. * -- 2.39.5