doc/salome/gui/SMESH/input/extrusion.doc

   1 /*!
   2
   3 \page extrusion_page Extrusion
   4
   5 \n Extrusion is used to build mesh elements of plus one
   6 dimension than the input ones. Boundary elements around generated
   7 mesh of plus one dimension are additionally created. All created
   8 elements can be automatically grouped. Extrusion can be used to create
   9 a \ref extrusion_struct "structured mesh from scratch".
  10
  11 \image html extrusion_box.png "If you extrude several quadrangles, you get exactly same mesh as if you meshed a geometrical box (except that the initial quadrangles can be incorrectly oriented): quadrangles and segments on boundary of generated mesh are created"
  12
  13 <p>Any node, segment or 2D element can be extruded. Each type of
  14 elements is extruded into a corresponding type of result elements:
  15 <table>
  16 <tr><td><b>Extruded element</b></td><td><b> Result element </b></td></tr>
  17 <tr><td>Node              </td><td> Segment </td></tr>
  18 <tr><td>Segment           </td><td> Quadrilateral </td></tr>
  19 <tr><td>Triangle          </td><td> Pentahedron </td></tr>
  20 <tr><td>Quadrilateral     </td><td> Hexahedron </td></tr>
  21 <tr><td>Polygon           </td><td> Polyhedron </td></tr>
  22 <tr><td>Hexagonal polygon </td><td> Hexagonal prism </td></tr>
  23 </table>
  24
  25 <em>To use extrusion:</em>
  26 <ol>
  27 <li>From the \b Modification menu choose the \b Extrusion item or click
  28 <em>"Extrusion"</em> button in the toolbar.
  29
  30 <center>
  31 \image html image91.png
  32 <em>"Extrusion" button</em>
  33 </center>
  34
  35 The following dialog, looking different depending on selected options,
  36 will appear:
  37
  38 \image html extrusionalongaline1.png
  39
  40 \image html extrusionalongaline2.png
  41
  42 \image html extrusionalongaline3.png
  43
  44 </li>
  45
  46 <li>In this dialog:
  47 <ul>
  48   <li>Specify \b Nodes, \b Edges and \b Faces, which will be extruded, by one
  49     of following means:
  50     <ul>
  51       <li><b>Select the whole mesh, sub-mesh or group</b> activating this
  52         checkbox.</li>
  53       <li>Choose mesh elements with the mouse in the 3D Viewer. It is
  54         possible to select a whole area with a mouse frame.</li>
  55       <li>Input the element IDs directly in <b>Node IDs</b>, <b>Edge
  56         IDs</b> and <b>Face IDs</b> fields. The selected elements will
  57         be highlighted in the viewer, if the mesh is shown there.</li>
  58       <li>Apply Filters. <b>Set filter</b> button allows to apply a
  59         filter to the selection of elements. See more about filters in
  60         the \ref filtering_elements "Selection filters" page.</li>
  61     </ul>
  62   </li>
  63   <li>If the <b>Extrusion to Distance</b> radio button is selected
  64     - specify the translation vector by which the elements will be extruded.
  65   </li>
  66   <li>If the <b>Extrusion Along Vector</b> radio button is selected
  67     <ul>
  68       <li>specify the coordinates of the \b Vector along which the elements
  69         will be extruded, either directly or by selecting the mesh face (the
  70         normal to the face will define the vector),</li>
  71       <li>specify the \b Distance of extrusion along the vector (it can
  72         be negative).</li>
  73     </ul>
  74   </li>
  75   <li>If the <b>Extrusion By Normal</b> radio button is selected,
  76     every node of selected faces is extruded along the \a average
  77     of the \a normal vectors to the faces sharing the node. (Nodes and
  78     edges can't be extruded in this mode.)
  79     <ul>
  80       <li>Specify the \b Distance of extrusion (it can be negative),</li>
  81       <li>Use <b>Along average normal</b> check-box to specify along
  82         what vector the distance is measured.
  83         <ul>
  84           <li>If it is \a activated the distance is measured along the
  85             average normal mentioned above. </li>
  86           <li>If it is \a deactivated every node is extruded along the
  87             average normal till its intersection with the virtual plane got
  88             by translation of the face sharing the node along its own normal
  89             by the \b Distance.</li>
  90         </ul>
  91         The picture below shows a cross-section of a 2D mesh extruded
  92         with <b>Along average normal</b> activated (to the left) and
  93         deactivated (to the right).
  94
  95         \image html extrusionbynormal_alongavgnorm.png "'Along average normal' activated (to the left) and deactivated (to the right)"
  96         <p></li>
  97
  98       <li>Using <b>Use only input elements</b> check-box specify what
  99         elements to use to compute the average normal.<ul>
 100           <li> If it is \a activated only selected faces, among faces
 101             sharing the node, are used to compute the average normal at
 102             the node. </li>
 103           <li>Else all faces sharing the node are used.</li></ul>
 104
 105         The picture below shows a cross-section of a 2D mesh the upper
 106         plane of which is extruded with <b>Use only input elements</b>
 107         activated (to the left) and deactivated (to the right).
 108
 109         \image html extrusionbynormal_useonly.png "'Use only input elements' activated (to the left) and deactivated (to the right)"
 110         <p></li>
 111   </li>
 112   </ul>
 113
 114   <li>Specify the <b>Number of steps</b>.</li>
 115   <li>If you activate <b>Generate Groups</b> check-box, the <em>result elements</em>
 116     created from <em>selected elements</em> contained in groups will be
 117     included into new groups named by pattern "<old group
 118     name>_extruded" and "<old group name>_top". For example if a
 119     selected quadrangle is included in \a g_Faces group (see figures
 120     below) then result hexahedra will be included in \a
 121     g_Faces_extruded group and a quadrangle created at the "top" of
 122     extruded mesh will be included in \a g_Faces_top group. <br>
 123 \image html extrusion_groups.png
 124 \image html extrusion_groups_res.png
 125     <p> This check-box is active only if there are some groups in the mesh.
 126   </li>
 127 </ul>
 128
 129 <li>Click \b Apply or <b> Apply and Close</b>  button to confirm the operation.</li>
 130 </ol>
 131 <p>
 132
 133 \anchor extrusion_struct
 134 <h2>Example: creation of a structured mesh from scratch</h2>
 135
 136 \image html image75.jpg "A node is extruded into a line of segments"
 137 <br>
 138 \image html image76.jpg "The line of segments is extruded into a quadrangle mesh"
 139 <br>
 140 \image html image77.jpg "The quadrangle mesh is revolved into a hexahedral mesh"
 141
 142
 143 <br><b>See Also</b> a sample TUI Script of an
 144 \ref tui_extrusion "Extrusion" operation.
 145
 146 */