Salome HOME
Fix Extrusion doc
[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. Each type of elements has a corresponding type of extruded elements:
8 <table>
9 <tr><td><b>Extruded element</b></td><td><b> Result element </b></td></tr>
10 <tr><td>Node              </td><td> Segment </td></tr>
11 <tr><td>Segment           </td><td> Quadrilateral </td></tr>
12 <tr><td>Triangle          </td><td> Pentahedron </td></tr>
13 <tr><td>Quadrilateral     </td><td> Hexahedron </td></tr>
14 <tr><td>Polygon           </td><td> Polyhedron </td></tr>
15 <tr><td>Hexagonal polygon </td><td> Hexagonal prism </td></tr>
16 </table>
17
18 <em>To use extrusion:</em>
19 <ol>
20 <li>From the \b Modification menu choose the \b Extrusion item or click
21 <em>"Extrusion"</em> button in the toolbar. 
22
23 <center>
24 \image html image91.png
25 <em>"Extrusion" button</em>
26 </center>
27
28 The following dialog common for line and planar elements will appear:
29
30 \image html extrusionalongaline1.png
31
32 \image html extrusionalongaline2.png
33
34 </li>
35
36 <li>In this dialog:
37 <ul>
38   <li>Select the type of elements which will be extruded (nodes, 1D or
39   2D elements).</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, the <em>result elements</em>
67     created from <em>extruded elements</em> contained in groups will be
68     included into new groups named by pattern "<old group
69     name>_extruded" and "<old group name>_top". For example if an
70     extruded quadrangle is included in \a Group_1 group then result
71     hexahedra will be included in \a Group_1_extruded group and a
72     quadrangle created at the "top" of extruded mesh will
73     be included in \a Group_1_top group. <br>This check-box is active
74     only if there are some groups in the mesh.</li>
75 </ul>
76
77 <li>Click \b Apply or <b> Apply and Close</b>  button to confirm the operation.</li>
78 </ol>
79
80 \image html image77.jpg "The mesh with an edge selected for extrusion"
81
82 \image html image76.jpg "The mesh with extruded edge" 
83
84 <br><b>See Also</b> a sample TUI Script of an 
85 \ref tui_extrusion "Extrusion" operation. 
86
87 */