Salome HOME
22812: EDF 9218 SMESH: An empty group is created when using the duplicate nodes and...
[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. Boundary elements around elements of
7 plus one dimension are additionally created. All created elements
8 can be automatically grouped.
9 <p>Any node, segment or 2D element can be extruded. Each type of
10 elements is extruded into a corresponding type of result elements:
11 <table>
12 <tr><td><b>Extruded element</b></td><td><b> Result element </b></td></tr>
13 <tr><td>Node              </td><td> Segment </td></tr>
14 <tr><td>Segment           </td><td> Quadrilateral </td></tr>
15 <tr><td>Triangle          </td><td> Pentahedron </td></tr>
16 <tr><td>Quadrilateral     </td><td> Hexahedron </td></tr>
17 <tr><td>Polygon           </td><td> Polyhedron </td></tr>
18 <tr><td>Hexagonal polygon </td><td> Hexagonal prism </td></tr>
19 </table>
20
21 <em>To use extrusion:</em>
22 <ol>
23 <li>From the \b Modification menu choose the \b Extrusion item or click
24 <em>"Extrusion"</em> button in the toolbar. 
25
26 <center>
27 \image html image91.png
28 <em>"Extrusion" button</em>
29 </center>
30
31 The following dialog common for line and planar elements will appear:
32
33 \image html extrusionalongaline1.png
34
35 \image html extrusionalongaline2.png
36
37 </li>
38
39 <li>In this dialog:
40 <ul>
41   <li>Select the type of elements which will be extruded (nodes, 1D or
42   2D elements).</li>
43   <li>Specify the IDs of the elements which will be extruded by one
44     following means:
45     <ul>
46       <li><b>Select the whole mesh, submesh or group</b> activating this
47         checkbox.</li>
48       <li>Choose mesh elements with the mouse in the 3D Viewer. It is
49         possible to select a whole area with a mouse frame.</li> 
50       <li>Input the element IDs directly in <b>ID Elements</b>
51         field. The selected elements will be highlighted in the viewer.</li> 
52       <li>Apply Filters. <b>Set filter</b> button allows to apply a
53         filter to the selection of elements. See more about filters in
54         the \ref filtering_elements "Selection filters" page.</li> 
55     </ul>
56   </li>
57   <li>If the <b>Extrude to Distance</b> radio button is selected</li>
58   <ul>
59     <li>specify the distance at which the elements will be extruded.</li>
60   </ul>
61   <li>If the <b>Extrude Along Vector</b> radio button is selected</li>
62   <ul>
63     <li>specify the coordinates of the vector along which the elements
64       will be extruded, or select the face (the normal to the face will
65       define the vector),</li>
66     <li>specify the distance of extrusion along the vector.</li>
67   </ul>
68   <li>Specify the number of steps.</li>
69   <li>If you activate <b>Generate Groups</b> check-box, the <em>result elements</em>
70     created from <em>extruded elements</em> contained in groups will be
71     included into new groups named by pattern "<old group
72     name>_extruded" and "<old group name>_top". For example if an
73     extruded quadrangle is included in \a Group_1 group then result
74     hexahedra will be included in \a Group_1_extruded group and a
75     quadrangle created at the "top" of extruded mesh will
76     be included in \a Group_1_top group. <br>This check-box is active
77     only if there are some groups in the mesh.</li>
78 </ul>
79
80 <li>Click \b Apply or <b> Apply and Close</b>  button to confirm the operation.</li>
81 </ol>
82
83 \image html image77.jpg "The mesh with an edge selected for extrusion"
84
85 \image html image76.jpg "The mesh with extruded edge" 
86
87 <br><b>See Also</b> a sample TUI Script of an 
88 \ref tui_extrusion "Extrusion" operation. 
89
90 */