Salome HOME
0020889: EDF 1433 SMESH: SplitHexaToTetra: add the 24 tetras mode
[modules/smesh.git] / doc / salome / gui / SMESH / input / adding_nodes_and_elements.doc
1 /*!
2
3 \page adding_nodes_and_elements_page Adding nodes and elements
4
5 \n In MESH you can add to your mesh different elements such as:
6
7 <ul>
8 <li>\ref adding_nodes_anchor "Nodes"</li>
9 <li>\ref adding_0delems_anchor "0D Elements"</li>
10 <li>\ref adding_edges_anchor "Edges"</li>
11 <li>\ref adding_triangles_anchor "Triangles"</li>
12 <li>\ref adding_quadrangles_anchor "Quadrangles"</li>
13 <li>\ref adding_polygons_anchor "Polygons"</li>
14 <li>\ref adding_tetrahedrons_anchor "Tetrahedrons"</li>
15 <li>\ref adding_hexahedrons_anchor "Hexahedrons"</li>
16 <li>\ref adding_polyhedrons_anchor "Polyhedrons"</li>
17 </ul>
18
19 <em>To add a node or an element to your mesh:</em>
20 <ol>
21 <li>Select your mesh in the Object Browser or in the 3D viewer.</li>
22
23 <li>From the \b Modification menu choose the \b Add item, the
24 following associated submenu will appear:</li>
25
26 \image html image146.png
27
28 From this submenu select the type of element which you would like to add to your mesh.
29
30 \note All dialogs for adding new node or element to the mesh (except for
31 the dialog for 0D elements) provide a possibility to add it
32 automatically to the specified group or to create it anew using
33 <b>Add to group</b> box, that allows to choose an existing group for
34 the created node or element or to give the name to a new group. By
35 default, the <b>Add to group</b> check box is switched off. If user
36 swiches this check box on, the combo box listing all currently
37 existing groups of the corresponding type becomes available. By
38 default, no any group is selected. In such a case, when user presses
39 <b>Apply</b> or <b>Apply & Close</b> button, the warning message box
40 informing the user about the necessity to input new group name is
41 shown. The combo box lists both \ref standalone_group "standalone groups"
42 and \ref group_on_geom "groups on geometry". If the user has 
43 chosen the group on geometry, he is warned and proposed to
44 \ref convert_to_standalone "convert this group to the standalone".
45 If user refuses converting operation, an operation is cancelled and
46 new node/element is not created!
47
48 </ol>
49
50 <b>See Also</b> sample TUI Scripts of  
51 \ref tui_adding_nodes_and_elements "Adding Nodes and Elements"
52 operations.  
53
54 <br>
55 \anchor adding_nodes_anchor
56 <h2>Adding nodes</h2>
57
58 \image html addnode.png
59
60 In this dialog box set coordinates for your node in the \b Coordinates
61 set of fields and click the \b Apply or <b>Apply and Close</b> button. Your node will be
62 created:
63
64 \image html add_node.png
65
66 <br>
67 \anchor adding_0delems_anchor
68 <h2>Adding 0D elements</h2>
69
70 \image html add0delement.png
71
72 In this dialog box specify the node which will form your 0d element by
73 selecting it in the 3D viewer and click the \b Apply or
74 <b>Apply and Close</b> button. Your 0D element will be created:
75
76 \image html add_0delement.png
77
78 <br>
79 \anchor adding_edges_anchor
80 <h2>Adding edges</h2>
81
82 \image html addedge.png
83
84 In this dialog box specify the nodes which will form your edge by
85 selecting them in the 3D viewer with pressed Shift button and click
86 the \b Apply or <b>Apply and Close</b> button. Your edge will be created:
87
88 \image html add_edge.png
89
90 <br>
91 \anchor adding_triangles_anchor
92 <h2>Adding triangles</h2>
93
94 \image html addtriangle.png
95
96 In this dialog box specify the nodes which will form your triangle by
97 selecting them in the 3D viewer with pressed Shift button and click
98 the \b Apply or <b>Apply and Close</b> button. Your triangle will be created:
99
100 \image html add_triangle.png
101
102 <br>
103 \anchor adding_quadrangles_anchor
104 <h2>Adding quadrangles</h2>
105
106 \image html addquadrangle.png
107
108 In this dialog box specify the nodes which will form your quadrangle
109 by selecting them in the 3D viewer with pressed Shift button and click
110 the \b Apply or <b>Apply and Close</b> button. Your quadrangle will be created:
111
112 \image html add_quadrangle.png
113
114 <br>
115 \anchor adding_polygons_anchor
116 <h2>Adding polygons</h2>
117
118 \image html addpolygon.png
119
120 In this dialog box specify the nodes which will form your polygon by
121 selecting them in the 3D viewer with pressed Shift button and click
122 the \b Apply or <b>Apply and Close</b> button.
123
124 \image html add_polygone.png
125
126 <br>
127 \anchor adding_tetrahedrons_anchor
128 <h2>Adding tetrahedrons</h2>
129
130 \image html addtetrahedron.png
131
132 In this dialog box specify the nodes which will form your tetrahedron
133 by selecting them in the 3D viewer with pressed Shift button and click
134 the \b Apply or <b>Apply and Close</b> button. Your tetrahedron will be created:
135
136 \image html image70.jpg
137
138 <br>
139 \anchor adding_hexahedrons_anchor
140 <h2>Adding hexahedrons</h2>
141
142 \image html addhexahedron.png
143
144 In this dialog box specify the nodes which will form your hexahedron
145 by selecting them in the 3D viewer with pressed Shift button and click
146 the \b Apply or <b>Apply and Close</b> button. Your hexahedron will be created:
147
148 \image html image71.jpg
149
150 <br>
151 \anchor adding_polyhedrons_anchor
152 <h2>Adding polyhedrons</h2>
153
154 \image html a-createpolyhedralvolume.png
155
156 There are two different ways to add polyhedral volumes. 
157 \n If you select \b Node as <b>Elements Type</b> you will specify the
158 nodes which will form the faces of your polyhedron by selecting the
159 nodes in the 3D viewer with pressed Shift button and clicking the \b
160 Add button to add the face in the list of Faces by Nodes, which will
161 form your polyhedron. Note, that it could be very useful to toggle
162 Polyhedron Preview checkbox to see the results of your selection.
163 \n The second way is somewhat simpler, however, there are cases when
164 it does not provide you with the necessary level of precision. If you
165 select \b Face as <b>Elements Type</b>, you will be able to select the faces
166 which will form your polyhedron in the 3D viewer with pressed Shift
167 button. If you've managed to obtain the necessary result, click the
168 \b Apply or <b>Apply and Close</b> button. Your polyhedron will be created:
169
170 \image html add_polyhedron.png
171
172 */