doc/salome/gui/SMESH/input/adding_nodes_and_elements.rst

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