From 5a541b7a7953bab663b4fbe577f8d587dc09c67e Mon Sep 17 00:00:00 2001 From: David Wells Date: Tue, 8 May 2018 12:05:23 -0400 Subject: [PATCH] Clarify Manifold attachment in some functions. --- include/deal.II/grid/grid_generator.h | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/include/deal.II/grid/grid_generator.h b/include/deal.II/grid/grid_generator.h index b4043ecb8b..52b0ee175c 100644 --- a/include/deal.II/grid/grid_generator.h +++ b/include/deal.II/grid/grid_generator.h @@ -951,6 +951,9 @@ namespace GridGenerator * will currently have to set boundary indicators again by hand in the * output triangulation. * + * @note Unlike most GridGenerator functions, this function does not attach + * any manifolds to @p result, nor does it set any manifold ids. + * * @note For a related operation on refined meshes when both meshes are * derived from the same coarse mesh, see * GridGenerator::create_union_triangulation(). @@ -986,6 +989,10 @@ namespace GridGenerator * from meshes for simpler geometries, then this is not the function for * you. Instead, consider GridGenerator::merge_triangulations(). * + * @note This function assumes that both @p triangulation_1 and @p + * triangulation_2 have the same manifold descriptions. The output + * Triangulation @p has the same manifold ids as these two triangulations. + * * @pre Both of the source conditions need to be available entirely locally. * In other words, they can not be objects of type * parallel::distributed::Triangulation. @@ -1018,6 +1025,9 @@ namespace GridGenerator * cells as are in @p input_triangulation, with the exception of the cells * listed in @p cells_to_remove. * + * @note Unlike most GridGenerator functions, this function does not attach + * any manifolds to @p result, nor does it set any manifold ids. + * * @pre Because we cannot create triangulations de novo that contain * adaptively refined cells, the input triangulation needs to have all of * its cells on the same level. Oftentimes, this will in fact be the @@ -1043,6 +1053,10 @@ namespace GridGenerator * * @note The 2d input triangulation @p input must be a coarse mesh that has * no refined cells. + * + * @note Since @p input and @p output have different spatial dimensions no + * manifold objects are copied (nor are any manifold ids set) by this + * function. */ void extrude_triangulation (const Triangulation<2, 2> &input, @@ -1062,6 +1076,10 @@ namespace GridGenerator * @note The 2d input triangulation @p input must be a coarse mesh that has * no refined cells. * + * @note Since @p input and @p output have different spatial dimensions no + * manifold objects are copied (nor are any manifold ids set) by this + * function. + * * @author Weixiong Zheng, 2018 */ void @@ -1094,6 +1112,10 @@ namespace GridGenerator * parallel::distributed::Triangulation, as well as when the input * Triangulation contains hanging nodes. * + * @note Since @p input and @p output have different spatial dimensions no + * manifold objects are copied by this function: you must attach new + * manifold objects to @p out_tria. + * * @author Luca Heltai, 2014 */ template @@ -1194,6 +1216,10 @@ namespace GridGenerator * faces to their corresponding surface mesh cells, for example to * accommodate different geometry descriptions in the case of curved * boundaries (but this is not currently implemented). + * + * @note Since @p volume_mesh and @p surface_mesh have different spatial + * dimensions no manifold objects are copied by this function: you must + * attach new manifold objects to @p surface_mesh. */ template