doc/salome/gui/SMESH/input/split_to_tetra.doc

   1 /*!
   2
   3 \page split_to_tetra_page Splitting volumes
   4
   5 \n This operation allows to split either any volumic elements into
   6 tetrahedra or hexahedra into prisms. 2D mesh is modified accordingly.
   7
   8 <em>To split volumes:</em>
   9 <ol>
  10 <li>Select a mesh, a sub-mesh or a group.</li>
  11 <li>In the \b Modification menu select the <b>Split Volumes</b> item or
  12 click <em>"Split Volumes"</em> button in the toolbar.
  13
  14 \image html split_into_tetra_icon.png
  15 <center><em>"Split Volumes" button</em></center>
  16
  17 The following dialog box will appear:
  18
  19 \image html split_into_tetra.png
  20
  21 <br>
  22 First it is possible to select the type of operation:
  23 - If \b Tetrahedron button is checked, the operation will split volumes of any type into tetrahedra.
  24 - If \b Prism button is checked, the operation will split hexahedra into prisms.
  25
  26 <ul>
  27 <li>The main list contains the list of volumes to split. You can click on
  28   a volume in the 3D viewer and it will be highlighted (lock Shift
  29   keyboard button to select several volumes). Click \b Add button and
  30   the ID of this volume will be added to the list. To remove the
  31   selected element or elements from the list click \b Remove button. <b>Sort
  32     list</b> button allows to sort the list of IDs. \b Filter button allows applying a filter to the selection of volumes.
  33   <br><b>Note:</b> If you split not all adjacent non-tetrahedral
  34   volumes, your mesh becomes non-conform.</li>
  35
  36 <li><b>Apply to all</b> radio button allows splitting all
  37   volumes of the currently selected mesh.</li>
  38
  39 <li>If \b Tetrahedron element type is selected, <b> Split hexahedron </b> group allows specifying the number of tetrahedra  a hexahedron will be split into. If the chosen method does not allow to get a conform mesh, a generic solution is applied: an additional node is created at the gravity center of a hexahedron, serving an apex of tetrahedra, all quadrangle sides of the hexahedron are split into two triangles each serving a base of a new tetrahedron.</li>
  40
  41 <li>If \b Prism element type is selected, the <b>Split hexahedron</b> group looks as follows:
  42
  43 \image html split_into_prisms.png
  44
  45 <ul>
  46 <li><b>Into 2 (or 4) prisms</b> allows to specify the number of prisms a hexahedron will be split into.</li>
  47 <li> <b> Facet to split </b> group allows to specify the side (facet) of the hexahedron, which is split into triangles.  This facet is defined by a point and a direction. The algorithm finds a hexahedron closest to the specified point and splits a facet whose normal is closest to the specified direction. Then the splitting is propagated from that hexahedron to all adjacent hexahedra.
  48 The point and the direction by which the first split hexahedron is found can be specified:
  49 <ul>
  50  <li> by input of coordinates in <b> Hexa location </b> and <b> Facet normal </b> fields, or </li>
  51  <li> by clicking <b>Selection</b> button and selecting in the viewer the element whose barycenter will be used as the start point and whose direction will be used as a normal to facet to split into triangles. Switch this button
  52 off to return to selection of volumes to split.</li>
  53 </ul>
  54
  55 <li> If <b> All domains </b> option is off, the operation stops when all
  56   hehexedra adjacent to the start hexahedron are split into
  57   prisms. Else the operation tries to continue splitting starting from
  58   another hexahedron closest to the <b> Hexa location</b>. </li>
  59 </li>
  60 </ul>
  61
  62 <li><b>Select from</b> set of fields allows choosing a sub-mesh or an
  63   existing group whose elements will be added to the list as you click \b Add button.</li>
  64 </ul>
  65
  66 <li>Click \b Apply or <b>Apply and Close</b> button to confirm the operation.</li>
  67 </ol>
  68 */