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