Salome HOME
Update SMESH documentation
[modules/smesh.git] / 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 point;</li>
49 </ul>
50 </li>
51
52 <li>specify the angle of revolution and the number of revolution steps,</li>
53 <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 
54  by 30 degrees twice for a total of 30*2=60)</li>
55
56 \image html revolutionsn2.png "Example of Revolution with Angle by Step"
57
58 <li> Total Angle - the elements are extruded by the specified angle only once and the number of steps defines the number of iterations 
59 (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>
60
61 \image html revolutionsn1.png "Example of Revolution with Total Angle"
62
63 </ul>
64 </li>
65
66 <li>specify the tolerance for the operation</li>
67
68 <li>activate  <b>Preview</b> checkbox to show the  parameter-setting in the viewer </li>
69 <li>activate  <b>Generate Groups</b> checkbox to copy the groups of
70 elements of the source mesh to the newly created one. </li>
71 </li>
72
73 <li>Click \b Apply or <b> Apply and Close</b> button to confirm the
74 operation.</li>
75 </ol>
76
77
78 <br><b>See Also</b> a sample TUI Script of a 
79 \ref tui_revolution "Revolution" operation.
80
81 */