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

   1 /*!
   2
   3 \page revolution_page Revolution
   4
   5 \n Revolution is a type of surface meshing by generation from
   6 discretized lines. It is used to build mesh elements of plus one
   7 dimension than the swept ones. Each swept 1D element produces one or
   8 more quadrangles (or triangles if one node of a rotated element lays
   9 on the revolution axis).
  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 common for line and planar elements will appear:
  20
  21 \image html revolution1.png
  22
  23 </li>
  24
  25 <li>
  26 In this dialog you should specify:
  27 <ul>
  28 <li>the type of elements which will be extruded (1D or 2D),</li>
  29 <li>specify the IDs of the elements which will be revolved:
  30
  31
  32 <ul>
  33 <li><b>Select the whole mesh, submesh or group</b> activating this
  34 checkbox; or</li>
  35 <li>choose mesh elements with the mouse in the 3D Viewer. It is
  36 possible to select a whole area with a mouse frame; or</li>
  37 <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
  38 viewer; or</li>
  39 <li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
  40 about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
  41 </ul>
  42 </li>
  43
  44 <li>specify the axis of revolution:
  45 <ul>
  46 <li>specify the cooordinates of the start \b Point of the vector of revolution;</li>
  47 <li>specify the \b Vector of revolution through the coordinates of its
  48 end point with respect to the coordinates of the start
  49 point. Alternatively, it is possible to specify the vector through the
  50 normal to the selected face.</li>
  51 </ul>
  52 </li>
  53
  54 <li>specify the angle of revolution and the number of revolution steps,</li>
  55 <ul> <li> Angle by Step - the elements are extruded by the specified angle at each step (i.e. for Angle=30 and Number of Steps=2, the elements will be extruded
  56  by 30 degrees twice for a total of 30*2=60)</li>
  57
  58 \image html revolutionsn2.png "Example of Revolution with Angle by Step"
  59
  60 <li> Total Angle - the elements are extruded by the specified angle only once and the number of steps defines the number of iterations
  61 (i.e.for Angle=30 and Number of Steps=2, the elements will be extruded by 30/2=15 degrees twice for a total of 30). </li>
  62
  63 \image html revolutionsn1.png "Example of Revolution with Total Angle"
  64
  65 </ul>
  66 </li>
  67
  68 <li>specify the tolerance for the operation</li>
  69
  70 <li>activate  <b>Preview</b> checkbox to show the  parameter-setting in the viewer </li>
  71 <li>activate  <b>Generate Groups</b> checkbox to copy the groups of
  72 elements of the source mesh to the newly created one. </li>
  73 </li>
  74 </ul>
  75
  76 <li>Click \b Apply or <b> Apply and Close</b> button to confirm the
  77 operation.</li>
  78 </ol>
  79
  80
  81 <br><b>See Also</b> a sample TUI Script of a
  82 \ref tui_revolution "Revolution" operation.
  83
  84 */