Salome HOME
Update copyrights in the documentation.
[modules/smesh.git] / doc / salome / gui / SMESH / input / adding_nodes_and_elements.doc
index 179e7885ab69ba13dff0a32d41ca683237758b1a..793525c02eebaf54c02ac8570b2f4d5fcfb543e0 100644 (file)
@@ -6,25 +6,56 @@
 
 <ul>
 <li>\ref adding_nodes_anchor "Nodes"</li>
+<li>\ref adding_0delems_anchor "0D Elements"</li>
+<li>\ref adding_0delems_on_all_nodes_anchor "0D elements on Element Nodes"</li>
+<li>\ref adding_balls_anchor "Ball Elements"</li>
 <li>\ref adding_edges_anchor "Edges"</li>
 <li>\ref adding_triangles_anchor "Triangles"</li>
 <li>\ref adding_quadrangles_anchor "Quadrangles"</li>
 <li>\ref adding_polygons_anchor "Polygons"</li>
 <li>\ref adding_tetrahedrons_anchor "Tetrahedrons"</li>
 <li>\ref adding_hexahedrons_anchor "Hexahedrons"</li>
+<li>\ref adding_octahedrons_anchor "Hexagonal prism"</li>
 <li>\ref adding_polyhedrons_anchor "Polyhedrons"</li>
 </ul>
 
+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 connectivity_page "here".
+
 <em>To add a node or an element to your mesh:</em>
 <ol>
-<li>Select your mesh in the Object Browser or in the 3D viewer.</li>
-
-<li>From the \b Modification menu choose the \b Add item, the
-following associated submenu will appear:</li>
-
-\image html image146.png
+  <li>Select your mesh in the Object Browser or in the 3D viewer.</li>
+
+  <li>From the \b Modification menu choose the \b Add item, the
+    following associated sub-menu will appear:</li>
+
+  \image html image152.png
+
+From this sub-menu select the type of element which you would like to add to your mesh.
+
+\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
+<b>Add to group</b> box, that allows choosing an existing group for
+the created node or element or giving the name to a new group. By
+default, the <b>Add to group</b> 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
+<b>Apply</b> or <b>Apply & Close</b> 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 grouping_elements_page "three types": both 
+\ref standalone_group "standalone groups",
+\ref group_on_filter "groups on filter", and 
+\ref group_on_geom "groups on geometry". 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!
 
-From this submenu select the type of element which you would like to add to your mesh.
 </ol>
 
 <b>See Also</b> sample TUI Scripts of  
@@ -43,10 +74,67 @@ created:
 
 \image html add_node.png
 
-\note You can also use variables defined in the SALOME \b NoteBook
-to specify coordinates of the node:
+<br>
+\anchor adding_0delems_anchor
+<h2>Adding 0D elements</h2>
+
+\image html add0delement.png
+
+In this dialog box specify nodes which will form your 0D elements by
+selecting them in the 3D viewer. Activate <b>Allow duplicate
+  elements</b> to get several 0D elements on a node. Click the \b Apply or
+<b>Apply and Close</b> button. Your 0D elements will be created:
 
-\image html addnode_notebook.png
+\image html add_0delement.png
+
+\anchor adding_0delems_on_all_nodes_anchor
+<h2>Making 0D elements on Element Nodes</h2>
+
+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.
+
+\image html dlg_0D_on_all_nodes.png
+
+In this dialog
+<ul>
+  <li> The radio-buttons allow choosing the type of object to create 0D elements on.
+    <ul>
+      <li><b> Mesh, sub-mesh, group </b> - 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. </li>
+      <li><b> Elements </b> - this button allows selecting elements in the
+        VTK viewer or typing their IDs in the dialog.</li>
+      <li><b> Nodes </b> - this button allows selecting nodes to create
+        0D elements on in the VTK viewer or typing their IDs in the dialog.</li>
+  </ul></li>
+  <li><b> Set Filter </b> button allows selecting elements or nodes
+    by filtering mesh elements or nodes with different criteria
+    (see \ref filtering_elements "Filter usage").</li>
+  <li>Activate <b>Allow duplicate elements</b> to get several 0D
+    elements on a node. </li>
+  <li> Switching on <b>Add to group</b> 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 grouping_elements_page "group" is not Standalone
+    (Group On Geometry or Group On Filter) it will be converted to
+    Standalone.
+    \warning If <b>Add to group</b> is activated it has to be filled in.
+</li>
+</ul>
+
+
+\anchor adding_balls_anchor
+<h2>Adding ball elements</h2>
+
+\image html addball.png
+
+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 \b Apply or <b>Apply and
+  Close</b> button.
+
+\image html add_ball.png
 
 <br>
 \anchor adding_edges_anchor
@@ -120,6 +208,16 @@ the \b Apply or <b>Apply and Close</b> button. Your hexahedron will be created:
 
 \image html image71.jpg
 
+<br>
+\anchor adding_octahedrons_anchor
+<h2>Adding hexagonal prism</h2>
+
+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 \b Apply or <b>Apply and Close</b> button. Your hexagonal prism will be created:
+
+\image html image_octa12.png
+
 <br>
 \anchor adding_polyhedrons_anchor
 <h2>Adding polyhedrons</h2>
@@ -142,4 +240,4 @@ button. If you've managed to obtain the necessary result, click the
 
 \image html add_polyhedron.png
 
-*/
\ No newline at end of file
+*/