Salome HOME
Fix description of "Generate groups"
[modules/smesh.git] / doc / salome / gui / SMESH / input / extrusion.doc
1 /*!
2
3 \page extrusion_page Extrusion
4
5 \n Extrusion is used to build mesh elements of plus one
6 dimension than the input ones. Any node, segment or 2D element can be
7 extruded. Element of each type extrude into elements of a certain type
8 as follows:
9 <table>
10 <tr><td><b>Extruded element</b></td><td><b> Result elements </b></td></tr>
11 <tr><td>Node              </td><td> Segments </td></tr>
12 <tr><td>Segment           </td><td> Quadrilaterals </td></tr>
13 <tr><td>Triangle          </td><td> Pentahedrons </td></tr>
14 <tr><td>Quadrilateral     </td><td> Hexahedrons </td></tr>
15 <tr><td>Polygon           </td><td> Polyhedrons </td></tr>
16 <tr><td>Hexagonal polygon </td><td> Hexagonal prism </td></tr>
17 </table>
18
19 <em>To use extrusion:</em>
20 <ol>
21 <li>From the \b Modification menu choose the \b Extrusion item or click
22 <em>"Extrusion"</em> button in the toolbar. 
23
24 <center>
25 \image html image91.png
26 <em>"Extrusion" button</em>
27 </center>
28
29 The following dialog common for line and planar elements will appear:
30
31 \image html extrusionalongaline1.png
32
33 \image html extrusionalongaline2.png
34
35 </li>
36
37 <li>In this dialog:
38 <ul>
39   <li>Select the type of elements which will be extruded (0D, 1D or 2D).</li>
40   <li>Specify the IDs of the elements which will be extruded by one
41     following means:
42     <ul>
43       <li><b>Select the whole mesh, submesh or group</b> activating this
44         checkbox.</li>
45       <li>Choose mesh elements with the mouse in the 3D Viewer. It is
46         possible to select a whole area with a mouse frame.</li> 
47       <li>Input the element IDs directly in <b>ID Elements</b>
48         field. The selected elements will be highlighted in the viewer.</li> 
49       <li>Apply Filters. <b>Set filter</b> button allows to apply a
50         filter to the selection of elements. See more about filters in
51         the \ref filtering_elements "Selection filters" page.</li> 
52     </ul>
53   </li>
54   <li>If the <b>Extrude to Distance</b> radio button is selected</li>
55   <ul>
56     <li>specify the distance at which the elements will be extruded.</li>
57   </ul>
58   <li>If the <b>Extrude Along Vector</b> radio button is selected</li>
59   <ul>
60     <li>specify the coordinates of the vector along which the elements
61       will be extruded, or select the face (the normal to the face will
62       define the vector),</li>
63     <li>specify the distance of extrusion along the vector.</li>
64   </ul>
65   <li>Specify the number of steps.</li>
66   <li>If you activate <b>Generate Groups</b> check-box then the created
67     elements contained in groups will be included into new groups named
68     by pattern "<old group name>_extruded". </li>
69 </ul>
70
71 <li>Click \b Apply or <b> Apply and Close</b>  button to confirm the operation.</li>
72 </ol>
73
74 \image html image77.jpg "The mesh with an edge selected for extrusion"
75
76 \image html image76.jpg "The mesh with extruded edge" 
77
78 <br><b>See Also</b> a sample TUI Script of an 
79 \ref tui_extrusion "Extrusion" operation. 
80
81 */