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:`Nodes <adding_nodes_anchor>`
  10 * :ref:`0D Elements <adding_0delems_anchor>`
  11 * :ref:`0D elements on Element Nodes <adding_0delems_on_all_nodes_anchor>`
  12 * :ref:`Ball Elements <adding_balls_anchor>`
  13 * :ref:`Edges <adding_edges_anchor>`
  14 * :ref:`Triangles <adding_triangles_anchor>`
  15 * :ref:`Quadrangles <adding_quadrangles_anchor>`
  16 * :ref:`Polygons <adding_polygons_anchor>`
  17 * :ref:`Tetrahedrons <adding_tetrahedrons_anchor>`
  18 * :ref:`Hexahedrons <adding_hexahedrons_anchor>`
  19 * :ref:`Hexagonal prism <adding_octahedrons_anchor>`
  20 * :ref:`Polyhedrons <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:`here <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:: 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 :ref:`three types <grouping_elements_page>`: both :ref:`standalone groups <standalone_group>`, :ref:`groups on filter <group_on_filter>`, and :ref:`groups on geometry <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. If the user rejects conversion operation, it is cancelled and a new node/element is not created!
  36
  37
  38 **See Also** sample TUI Scripts of :ref:`tui_adding_nodes_and_elements` operations.
  39
  40 .. _adding_nodes_anchor:
  41
  42 Adding nodes
  43 ############
  44
  45 .. image:: ../images/addnode.png
  46         :align: center
  47
  48 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:
  49
  50 .. image:: ../images/add_node.png
  51         :align: center
  52
  53
  54 .. _adding_0delems_anchor:
  55
  56 Adding 0D elements
  57 ##################
  58
  59 .. image:: ../images/add0delement.png
  60         :align: center
  61
  62 In this dialog box specify nodes which will form your 0D elements by selecting them in the 3D viewer. Activate **Allow duplicate elements**
  63 to get several 0D elements on a node. Click the **Apply** or **Apply and Close** button. Your 0D elements will be created:
  64
  65 .. image:: ../images/add_0delement.png
  66         :align: center
  67
  68
  69 .. _adding_0delems_on_all_nodes_anchor:
  70
  71 Making 0D elements on Element Nodes
  72 ###################################
  73
  74 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.
  75
  76 .. image:: ../images/dlg_0D_on_all_nodes.png
  77         :align: center
  78
  79 In this dialog
  80
  81 *  The radio-buttons allow choosing the type of object to create 0D elements on.
  82
  83         * **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.
  84         * **Elements** - this button allows selecting elements in the VTK viewer or typing their IDs in the dialog.
  85         * **Nodes** - this button allows selecting nodes to create 0D elements on in the VTK viewer or typing their IDs in the dialog.
  86
  87 * **Set Filter** button allows selecting elements or nodes by filtering mesh elements or nodes with different criteria (see :ref:`Filter usage <filtering_elements>`).
  88 * Activate **Allow duplicate elements** to get several 0D elements on a node.
  89 * 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:`group <grouping_elements_page>` is not Standalone (Group On Geometry or Group On Filter) it will be converted to Standalone.
  90
  91 .. warning:: If **Add to group** is activated it has to be filled in.
  92
  93
  94
  95
  96 .. _adding_balls_anchor:
  97
  98 Adding ball elements
  99 ####################
 100
 101 .. image:: ../images/addball.png
 102         :align: center
 103
 104 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.
 105
 106 .. image:: ../images/add_ball.png
 107         :align: center
 108
 109
 110 .. _adding_edges_anchor:
 111
 112 Adding edges
 113 ############
 114
 115 .. image:: ../images/addedge.png
 116         :align: center
 117
 118 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:
 119
 120 .. image:: ../images/add_edge.png
 121         :align: center
 122
 123
 124 .. _adding_triangles_anchor:
 125
 126 Adding triangles
 127 ################
 128
 129 .. image:: ../images/addtriangle.png
 130         :align: center
 131
 132 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:
 133
 134 .. image:: ../images/add_triangle.png
 135         :align: center
 136
 137
 138 .. _adding_quadrangles_anchor:
 139
 140 Adding quadrangles
 141 ##################
 142
 143 .. image:: ../images/addquadrangle.png
 144         :align: center
 145
 146 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:
 147
 148 .. image:: ../images/add_quadrangle.png
 149         :align: center
 150
 151
 152 .. _adding_polygons_anchor:
 153
 154 Adding polygons
 155 ###############
 156
 157 .. image:: ../images/addpolygon.png
 158         :align: center
 159
 160 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.
 161
 162 .. image:: ../images/add_polygone.png
 163         :align: center
 164
 165
 166 .. _adding_tetrahedrons_anchor:
 167
 168 Adding tetrahedrons
 169 ###################
 170
 171 .. image:: ../images/addtetrahedron.png
 172         :align: center
 173
 174 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:
 175
 176 .. image:: ../images/image70.jpg
 177         :align: center
 178
 179
 180 .. _adding_hexahedrons_anchor:
 181
 182 Adding hexahedrons
 183 ##################
 184
 185 .. image:: ../images/addhexahedron.png
 186         :align: center
 187
 188 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
 189 the **Apply** or **Apply and Close** button. Your hexahedron will be created:
 190
 191 .. image:: ../images/image71.jpg
 192         :align: center
 193
 194 .. _adding_octahedrons_anchor:
 195
 196 Adding hexagonal prism
 197 ######################
 198
 199 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:
 200
 201 .. image:: ../images/image_octa12.png
 202         :align: center
 203
 204
 205 .. _adding_polyhedrons_anchor:
 206
 207 Adding polyhedrons
 208 ##################
 209
 210 .. image:: ../images/a-createpolyhedralvolume.png
 211         :align: center
 212
 213 There are two different ways to add polyhedral volumes.
 214
 215 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.
 216 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:
 217
 218 .. image:: ../images/add_polyhedron.png
 219         :align: center
 220