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