]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Minor updates to bounding box documentation. 14666/head
authorWolfgang Bangerth <bangerth@colostate.edu>
Wed, 11 Jan 2023 17:54:41 +0000 (10:54 -0700)
committerWolfgang Bangerth <bangerth@colostate.edu>
Wed, 11 Jan 2023 21:05:23 +0000 (14:05 -0700)
include/deal.II/base/bounding_box.h

index 6ea5bc3354919de6a40d53b1b67a24d03b5d33b0..dcca720b1707e9d4d955bbe814f75a8ddfef5079 100644 (file)
@@ -39,15 +39,17 @@ enum class NeighborType
 
   /**
    * Simple neighbors: the boxes intersect with an intersection of dimension at
-   * most `spacedim - 2`. For example, in 2d this means that the two boxes
-   * touch at one corner of the each box.
+   * most `spacedim - 2`. For example, in 2d this means that the two rectangles
+   * touch at a single point, which must then be a vertex of each box. In 3d,
+   * this means that two boxes touch along an edge.
    */
   simple_neighbors = 1,
 
   /**
    * Attached neighbors: neighbors with an intersection of
    * `dimension > spacedim - 2`. For example, in 2d this means that the two
-   * boxes touch along an edge.
+   * rectangles touch along (parts of) their edges. In 3d, it would mean that
+   * two boxes touch along (parts of) their faces.
    */
   attached_neighbors = 2,
 
@@ -59,7 +61,9 @@ enum class NeighborType
    *  |  |  | =  |     |
    *  V--W--.    V-----.
    *  @endcode
-   * or one is inside the other
+   * or one is inside the other. This is a special case of `attached_neighbors`
+   * where the two bounding boxes touch along the entirety of their respective
+   * faces, or where they overlap in suitable ways.
    */
   mergeable_neighbors = 3
 };

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.