doc/salome/gui/SMESH/input/prism_3d_algo.doc

   1 /*!
   2
   3 \page prism_3d_algo_page 3D extrusion meshing algorithm
   4
   5 3D extrusion algorithm can be used for meshing prisms, i.e. 3D shapes
   6 defined by two opposing faces having the same number of vertices and
   7 edges. These two faces should be connected by quadrangle "side" faces.
   8
   9 The prism is allowed to have sides composed of several faces. (A prism
  10 side is a row of faces (or one face) connecting corresponding edges of
  11 the top and base faces). But there is a limitation that a prism
  12 side is allowed to be split only vertically as indicated in the
  13 picture below.
  14
  15 \image html prism_ok_ko.png
  16 In this picture, the left prism is suitable for meshing with 3D
  17 extrusion algorithm; it has six sides two of which are split
  18 vertically. And the right prism can't be meshed with this
  19 algorithm because one of the prism sides is split horizontally (a
  20 splitting edge is highlighted).
  21
  22 The algorithm can propagate 2D mesh not only between horizontal
  23 (i.e. base and top) faces of one prism but also between faces of prisms
  24 organized in a stack and between stacks sharing prism sides.
  25
  26 \image html prism_stack.png
  27 In this picture, four neighboring prism stacks, each comprising two prisms,
  28 are shown. The shown sub-mesh is used by the algorithm to mesh
  29 all the eight prisms in the stacks.
  30
  31 To use <em>3D extrusion</em> algorithm you need to assign algorithms
  32 and hypotheses of lower dimension as follows.
  33
  34 \b Global algorithms and hypotheses to be chosen at
  35 \ref create_mesh_anchor "Creation of a mesh object" are:
  36 <ul>
  37 <li> 1D algorithm and hypothesis that will be applied for meshing
  38 (logically) vertical edges of the prism (these edges connect the top and
  39 base faces of prism).</li>
  40 </ul>
  41
  42 \b Local algorithms and hypotheses to be chosen at
  43 \ref constructing_submeshes_page "Constructing sub-meshes" are:
  44 <ul>
  45 <li> 1D and 2D algorithms and hypotheses that will be applied for
  46 meshing the top and base prism faces. These faces can be meshed
  47 with any type of 2D elements: quadrangles, triangles, polygons or
  48 their mix. It's enough to define a sub-mesh on either top or base face
  49 only.</li>
  50 <li> Optionally you can define an 1D sub-mesh on some vertical edges
  51 of stacked prisms, which will override the global 1D hypothesis mentioned
  52 above. In the above picture, the vertical division is not equidistant
  53 on all the length because of a "Number Of Segments" hypothesis with
  54 Scale Factor=3 assigned to one of edges between the shifted stacks.
  55 </li></ul>
  56
  57 \image html image157.gif "Prism with 3D extrusion meshing"
  58
  59 As you can see, the <em>3D extrusion</em> algorithm permits to build
  60 in the same 3D mesh such elements as hexahedrons, prisms and
  61 polyhedrons.
  62
  63 \sa a sample TUI Script of
  64 \ref tui_prism_3d_algo "Use 3D extrusion meshing algorithm".
  65
  66 */