Salome HOME
173db3ce1e32f194696fe57a233f16327b1beb99
[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_0delems_on_all_nodes_anchor "0D elements on Element Nodes"</li>
11 <li>\ref adding_balls_anchor "Ball Elements"</li>
12 <li>\ref adding_edges_anchor "Edges"</li>
13 <li>\ref adding_triangles_anchor "Triangles"</li>
14 <li>\ref adding_quadrangles_anchor "Quadrangles"</li>
15 <li>\ref adding_polygons_anchor "Polygons"</li>
16 <li>\ref adding_tetrahedrons_anchor "Tetrahedrons"</li>
17 <li>\ref adding_hexahedrons_anchor "Hexahedrons"</li>
18 <li>\ref adding_octahedrons_anchor "Hexagonal prism"</li>
19 <li>\ref adding_polyhedrons_anchor "Polyhedrons"</li>
20 </ul>
21
22 The convention of nodal connectivity of elements used in SALOME is
23 the MED library convention. You can consult the description of
24 nodal connectivity of elements in the documentation on MED library or 
25 \ref connectivity_page "here".
26
27 <em>To add a node or an element to your mesh:</em>
28 <ol>
29   <li>Select your mesh in the Object Browser or in the 3D viewer.</li>
30
31   <li>From the \b Modification menu choose the \b Add item, the
32     following associated sub-menu will appear:</li>
33
34   \image html image152.png
35
36 From this sub-menu select the type of element which you would like to add to your mesh.
37
38 \note All dialogs for new node or element adding to the mesh provide
39 the possibility to automatically add
40 a node or element to the specified group or to create it anew using
41 <b>Add to group</b> box, that allows choosing an existing group for
42 the created node or element or giving the name to a new group. By
43 default, the <b>Add to group</b> check box is switched off. If the user
44 switches this check box on, the combo box listing all currently
45 existing groups of the corresponding type becomes available. By
46 default, no group is selected. In this case, when the user presses
47 <b>Apply</b> or <b>Apply & Close</b> button, the warning message box
48 informs the user about the necessity to input new group name. The
49 combo box lists groups of all the 
50 \ref grouping_elements_page "three types": both 
51 \ref standalone_group "standalone groups",
52 \ref group_on_filter "groups on filter", and 
53 \ref group_on_geom "groups on geometry". If the user chooses a
54 group on geometry or on filter, he is warned and proposed to
55 convert this group to standalone.
56 If the user rejects conversion operation, it is cancelled and
57 a new node/element is not created!
58
59 </ol>
60
61 <b>See Also</b> sample TUI Scripts of  
62 \ref tui_adding_nodes_and_elements "Adding Nodes and Elements"
63 operations.  
64
65 <br>
66 \anchor adding_nodes_anchor
67 <h2>Adding nodes</h2>
68
69 \image html addnode.png
70
71 In this dialog box set coordinates for your node in the \b Coordinates
72 set of fields and click the \b Apply or <b>Apply and Close</b> button. Your node will be
73 created:
74
75 \image html add_node.png
76
77 <br>
78 \anchor adding_0delems_anchor
79 <h2>Adding 0D elements</h2>
80
81 \image html add0delement.png
82
83 In this dialog box specify nodes which will form your 0D elements by
84 selecting them in the 3D viewer and click the \b Apply or
85 <b>Apply and Close</b> button. Your 0D elements will be created:
86
87 \image html add_0delement.png
88
89 \anchor adding_0delems_on_all_nodes_anchor
90 <h2>Making 0D elements on Element Nodes</h2>
91
92 There is another way to create 0D elements. It is possible to create
93 0D elements on all nodes of the selected mesh, sub-mesh, or a group of elements or nodes.
94
95 \image html dlg_0D_on_all_nodes.png
96
97 In this dialog
98 <ul>
99   <li> The radio-buttons allow choosing the type of object to create 0D elements on.
100     <ul>
101       <li><b> Mesh, sub-mesh, group </b> - this button allows selecting
102         a mesh, a sub-mesh or a group to create 0D elements on the nodes of its
103         elements. The name of the selected object is shown in the dialog. </li>
104       <li><b> Elements </b> - this button allows selecting elements in the
105         VTK viewer or typing their IDs in the dialog.</li>
106       <li><b> Nodes </b> - this button allows selecting nodes to create
107         0D elements on in the VTK viewer or typing their IDs in the dialog.</li>
108   </ul></li>
109   <li><b> Set Filter </b> button allows selecting elements or nodes
110     by filtering mesh elements or nodes with different criteria
111     (see \ref filtering_elements "Filter usage").</li>
112   <li> Switching on <b>Add to group</b> check-box allows specifying the
113     name of the group to which all created or found (existing) 0D elements will
114     be added. You can either select an existing group from a drop-down
115     list, or enter the name of the group to be created. If a selected
116     existing \ref grouping_elements_page "group" is not Standalone
117     (Group On Geometry or Group On Filter) it will be converted to
118     Standalone.
119     \warning If <b>Add to group</b> is activated it has to be filled in.
120 </li>
121 </ul>
122
123
124 \anchor adding_balls_anchor
125 <h2>Adding ball elements</h2>
126
127 \image html addball.png
128
129 In this dialog box specify the nodes, which will form your ball elements,
130 either by selecting them in the 3D viewer or by manually entering their IDs,
131 specify the ball diameter and click the \b Apply or <b>Apply and
132   Close</b> button.
133
134 \image html add_ball.png
135
136 <br>
137 \anchor adding_edges_anchor
138 <h2>Adding edges</h2>
139
140 \image html addedge.png
141
142 In this dialog box specify the nodes which will form your edge by
143 selecting them in the 3D viewer with pressed Shift button and click
144 the \b Apply or <b>Apply and Close</b> button. Your edge will be created:
145
146 \image html add_edge.png
147
148 <br>
149 \anchor adding_triangles_anchor
150 <h2>Adding triangles</h2>
151
152 \image html addtriangle.png
153
154 In this dialog box specify the nodes which will form your triangle by
155 selecting them in the 3D viewer with pressed Shift button and click
156 the \b Apply or <b>Apply and Close</b> button. Your triangle will be created:
157
158 \image html add_triangle.png
159
160 <br>
161 \anchor adding_quadrangles_anchor
162 <h2>Adding quadrangles</h2>
163
164 \image html addquadrangle.png
165
166 In this dialog box specify the nodes which will form your quadrangle
167 by selecting them in the 3D viewer with pressed Shift button and click
168 the \b Apply or <b>Apply and Close</b> button. Your quadrangle will be created:
169
170 \image html add_quadrangle.png
171
172 <br>
173 \anchor adding_polygons_anchor
174 <h2>Adding polygons</h2>
175
176 \image html addpolygon.png
177
178 In this dialog box specify the nodes which will form your polygon by
179 selecting them in the 3D viewer with pressed Shift button and click
180 the \b Apply or <b>Apply and Close</b> button.
181
182 \image html add_polygone.png
183
184 <br>
185 \anchor adding_tetrahedrons_anchor
186 <h2>Adding tetrahedrons</h2>
187
188 \image html addtetrahedron.png
189
190 In this dialog box specify the nodes which will form your tetrahedron
191 by selecting them in the 3D viewer with pressed Shift button and click
192 the \b Apply or <b>Apply and Close</b> button. Your tetrahedron will be created:
193
194 \image html image70.jpg
195
196 <br>
197 \anchor adding_hexahedrons_anchor
198 <h2>Adding hexahedrons</h2>
199
200 \image html addhexahedron.png
201
202 In this dialog box specify the nodes which will form your hexahedron
203 by selecting them in the 3D viewer with pressed Shift button and click
204 the \b Apply or <b>Apply and Close</b> button. Your hexahedron will be created:
205
206 \image html image71.jpg
207
208 <br>
209 \anchor adding_octahedrons_anchor
210 <h2>Adding hexagonal prism</h2>
211
212 In the Add Hexagonal Prism dialog box specify the nodes which will
213 form your hexagonal prism by selecting them in the 3D viewer with pressed Shift button and click
214 the \b Apply or <b>Apply and Close</b> button. Your hexagonal prism will be created:
215
216 \image html image_octa12.png
217
218 <br>
219 \anchor adding_polyhedrons_anchor
220 <h2>Adding polyhedrons</h2>
221
222 \image html a-createpolyhedralvolume.png
223
224 There are two different ways to add polyhedral volumes. 
225 \n If you select \b Node as <b>Elements Type</b> you will specify the
226 nodes which will form the faces of your polyhedron by selecting the
227 nodes in the 3D viewer with pressed Shift button and clicking the \b
228 Add button to add the face in the list of Faces by Nodes, which will
229 form your polyhedron. Note, that it could be very useful to toggle
230 Polyhedron Preview checkbox to see the results of your selection.
231 \n The second way is somewhat simpler, however, there are cases when
232 it does not provide you with the necessary level of precision. If you
233 select \b Face as <b>Elements Type</b>, you will be able to select the faces
234 which will form your polyhedron in the 3D viewer with pressed Shift
235 button. If you've managed to obtain the necessary result, click the
236 \b Apply or <b>Apply and Close</b> button. Your polyhedron will be created:
237
238 \image html add_polyhedron.png
239
240 */