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