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

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