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