doc/salome/gui/SMESH/input/revolution.doc

   1 /*!
   2
   3 \page revolution_page Revolution
   4
   5 \n Revolution 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. Revolution can be used to create
   9 a \ref extrusion_struct "structured mesh from scratch".
  10
  11 <em>To apply revolution:</em>
  12 <ol>
  13   <li>From the \b Modification menu choose the \b Revolution item or click
  14     <em>"Revolution"</em> button in the toolbar.
  15
  16 \image html image92.png
  17 <center><em>"Revolution" button</em></center>
  18
  19 The following dialog will appear:
  20
  21 \image html revolution1.png
  22
  23   </li>
  24
  25   <li>In this dialog:
  26     <ul>
  27     <li>Use \a Selection button to specify what you are going to
  28     select at a given moment, \b Nodes, \b Edges or \b Faces.
  29 \image html image120.png
  30 <center><em>"Selection" button</em></center>
  31     </li>
  32     <li>Specify \b Nodes, \b Edges and \b Faces, which will be revolved, by one
  33       of following means:
  34       <ul>
  35         <li><b>Select the whole mesh, sub-mesh or group</b> activating this
  36           checkbox.</li>
  37         <li>Choose mesh elements with the mouse in the 3D Viewer. It is
  38           possible to select a whole area with a mouse frame.</li>
  39         <li>Input the element IDs directly in <b>Node IDs</b>, <b>Edge
  40             IDs</b> and <b>Face IDs</b> fields. The selected elements will
  41           be highlighted in the viewer, if the mesh is shown there.</li>
  42         <li>Apply Filters. <b>Set filter</b> button allows to apply a
  43           filter to the selection of elements. See more about filters in
  44           the \ref filtering_elements "Selection filters" page.</li>
  45       </ul>
  46     </li>
  47     <li>Specify the \b Axis of revolution:
  48       <ul>
  49         <li>Specify the cooordinates of the start \b Point of the
  50           axis of revolution; either directly or by picking a node
  51           in the Viewer (selection of nodes is activated as you click
  52           the \a Selection button).</li>
  53         <li>Specify the \b Vector of the axis in either of three ways:
  54           <ul>
  55             <li>directly adjust vector components;</li>
  56             <li>click \a Selection button, chose <em>From Origin to
  57                 selected Point</em> in the opened menu and pick a node
  58                 in the Viewer; </li>
  59             <li>click \a Selection button, chose <em>Normal to
  60                 selected Face</em> in the opened menu and pick a mesh
  61                 face in the Viewer.</li>
  62       </ul></ul>
  63     </li>
  64     <li>Specify the \b Angle of revolution and the <b>Number of
  65         steps </b> of revolution,
  66       <ul>
  67         <li> <b>Angle by Step</b> - the elements are revolved by the
  68           specified angle at each step (i.e. for Angle=30 and Number of
  69           Steps=2, the elements will be extruded by 30 degrees twice for a
  70           total of 30*2=60)
  71 \image html revolutionsn2.png "Example of Revolution with Angle by Step"
  72         </li>
  73         <li> <b>Total Angle</b> - the elements are revolved by the
  74           specified angle only once and the number of steps defines the
  75           number of iterations (i.e. for Angle=30 and Number of Steps=2,
  76           the elements will be revolved by 30/2=15 degrees twice for a
  77           total of 30).
  78 \image html revolutionsn1.png "Example of Revolution with Total Angle"
  79         </li>
  80       </ul>
  81     </li>
  82     <li>Specify the \b Tolerance, which is used to detect nodes lying
  83       on the axis of revolution.
  84     </li>
  85     <li>Activate  <b>Preview</b> check-box to see the result mesh in
  86       the viewer.
  87     </li>
  88     <li>If you activate <b>Generate Groups</b> check-box, the <em>result elements</em>
  89       created from <em>selected elements</em> contained in groups will be
  90       included into new groups named by pattern "<old group
  91       name>_rotated" and "<old group name>_top". For example if a
  92       selected quadrangle is included in \a g_Faces group (see figures
  93       below) then result hexahedra will be included in \a
  94       g_Faces_rotated group and a quadrangle created at the "top" of
  95       revolved mesh will be included in \a g_Faces_top group. <br>
  96 \image html extrusion_groups.png
  97 \image html extrusion_groups_res.png
  98     <p> This check-box is active only if there are some groups in the mesh.
  99     </li>
 100     </ul>
 101   </li>
 102
 103   <li>Click \b Apply or <b> Apply and Close</b> button to confirm the
 104     operation.</li>
 105 </ol>
 106
 107 <br><b>See Also</b> a sample TUI Script of a
 108 \ref tui_revolution "Revolution" operation.
 109
 110 */