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