From c1391a5371a0549b9cec8991ab317accf61850e3 Mon Sep 17 00:00:00 2001 From: hartmann Date: Tue, 12 Dec 2006 09:24:13 +0000 Subject: [PATCH] Fix docu of patch_level_1. git-svn-id: https://svn.dealii.org/trunk@14223 0785d39b-7218-0410-832d-ea1e28bc413d --- deal.II/deal.II/include/grid/tria.h | 20 +++++++++++++------- deal.II/deal.II/source/grid/tria.cc | 6 +++--- 2 files changed, 16 insertions(+), 10 deletions(-) diff --git a/deal.II/deal.II/include/grid/tria.h b/deal.II/deal.II/include/grid/tria.h index 25ad6e805b..c8f721a1dd 100644 --- a/deal.II/deal.II/include/grid/tria.h +++ b/deal.II/deal.II/include/grid/tria.h @@ -793,13 +793,19 @@ namespace internal * be refined after the step. * *
  • @p patch_level_1: - * Ensures patch level 1. As result the triangulation consists of - * patches, i.e. of cells that are refined once. It follows that - * if at least one of the children of a cell is or will be refined - * than all children need to be refined. If the @p patch_level_1 flag - * is set, than the flags @p eliminate_unrefined_islands, - * @p eliminate_refined_inner_islands and - * @p eliminate_refined_boundary_islands will be ignored as they will + * A triangulation of patch level 1 consists of patches, i.e. of + * cells that are refined once. This flag ensures that a mesh of + * patch level 1 is still of patch level 1 after coarsening and + * refinement. It is, however, the user's responsibility to ensure + * that the mesh is of patch level 1 before calling + * execute_coarsening_and_refinement the first time. The easiest + * way to achieve this is by calling global_refine(1) straight + * after creation of the triangulation. It follows that if at + * least one of the children of a cell is or will be refined than + * all children need to be refined. If the @p patch_level_1 flag + * is set, than the flags @p eliminate_unrefined_islands, @p + * eliminate_refined_inner_islands and @p + * eliminate_refined_boundary_islands will be ignored as they will * be fulfilled automatically. * *
  • @p smoothing_on_refinement: diff --git a/deal.II/deal.II/source/grid/tria.cc b/deal.II/deal.II/source/grid/tria.cc index 851ed5a2c7..d726f7037f 100644 --- a/deal.II/deal.II/source/grid/tria.cc +++ b/deal.II/deal.II/source/grid/tria.cc @@ -7590,7 +7590,7 @@ bool Triangulation::prepare_coarsening_and_refinement () // need to be refined. This step // only sets refinement flags and does // not set coarsening flags. - // If the path_level_1 flag is set, than + // If the path_level_1 flag is set, then // eliminate_unrefined_islands, // eliminate_refined_inner_islands and // eliminate_refined_boundary_islands will @@ -8007,7 +8007,7 @@ bool Triangulation::prepare_coarsening_and_refinement () // - patch level n says that // the triangulation consists // of patches of level n. - // This does make sence only + // This makes sense only // if the grid is already at // least n times globally // refined. @@ -8030,7 +8030,7 @@ bool Triangulation::prepare_coarsening_and_refinement () // (A) is that before // calling this function // the grid was already of - // patch level 2. + // patch level 1. // loop over all cells // whose children are all -- 2.39.5