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