Salome HOME
bos #29171 Refactor testing procedure
[modules/smesh.git] / doc / gui / input / removing_nodes_and_elements.rst
1 .. _removing_nodes_and_elements_page:
2
3 ***************************
4 Removing nodes and elements
5 ***************************
6
7 In MESH you can remove nodes and all types of cells of your mesh.
8
9 * :ref:`removing_nodes_anchor`
10 * :ref:`removing_nodes_reconnect_anchor`
11 * :ref:`removing_orphan_nodes_anchor`
12 * :ref:`removing_elements_anchor`
13 * :ref:`clear_mesh_anchor`
14
15
16
17 .. _removing_nodes_anchor:
18
19 Removing nodes
20 ##############
21
22 **To remove a node:**
23
24 .. |rmn| image:: ../images/remove_nodes_icon.png
25
26 #. Select your mesh in the Object Browser or in the 3D viewer.
27 #. From the **Modification** menu choose **Remove** and from the associated submenu select the **Nodes**, or just click *"Remove nodes"* button |rmn| in the toolbar.
28    The following dialog box will appear:
29
30         .. image:: ../images/removenodes.png
31                 :align: center
32
33
34    In this dialog box you can specify one or several nodes:
35
36    * choose mesh nodes with the mouse in the 3D Viewer. It is possible to select a whole area with a mouse frame; or 
37    * input the node IDs directly in **Node IDs** field. The selected nodes will be highlighted in the viewer; or
38    * apply Filters. **Set filter** button allows to apply a filter to the selection of nodes. See more about filters in the :ref:`selection_filter_library_page` page.
39
40 #. Click **Apply** or **Apply and Close** to confirm deletion of the specified nodes.
41
42 .. note::
43         Be careful while removing nodes because if you remove a definite node of your mesh all adjacent elements will be also deleted.
44
45
46 .. _removing_nodes_reconnect_anchor:
47
48 Removing node with reconnection
49 ###############################
50
51 This operation removes a node and changes surrounding faces in order to cover a hole appearing in the mesh. This operation applies to 2D triangle mesh only.
52
53         .. image:: ../images/remove_node_reconnection.png
54                 :align: center
55
56 **To remove a node:**
57
58 .. |rmnr| image:: ../images/remove_node_reconnection_icon.png
59
60 #. Select your mesh in the Object Browser or in the 3D viewer.
61 #. From the **Modification** menu choose **Remove** and from the associated submenu select the **Node with reconnection**, or just click *"Remove node with reconnection"* button |rmnr| in the toolbar.
62    The following dialog box will appear:
63
64         .. image:: ../images/remove_node_reconnection_dlg.png
65                 :align: center
66
67
68    In this dialog box you can specify one node to remove:
69
70    * choose a mesh node with the mouse in the 3D Viewer or 
71    * input the node ID directly in **ID** field. The selected node will be highlighted in the viewer.
72
73    Activate **Preview** to see how faces will change.
74
75 #. Click **Apply** or **Apply and Close** to confirm deletion of the specified node.
76
77
78 .. _removing_orphan_nodes_anchor:
79
80 Removing orphan nodes
81 #####################
82
83 There is a quick way to remove all orphan (free) nodes.
84
85 *To remove orphan nodes:*
86
87 .. |rmon| image:: ../images/remove_orphan_nodes_icon.png
88
89 #. Select your mesh in the Object Browser or in the 3D viewer.
90 #. From the **Modification** menu choose **Remove** and from the associated submenu select **Orphan Nodes**, or just click *"Remove orphan nodes"* button |rmon| in the toolbar.
91    The following Warning message box will appear:
92
93         .. image:: ../images/removeorphannodes.png
94                 :align: center
95
96 #. Confirm nodes removal by pressing "Yes" button.
97
98
99 .. _removing_elements_anchor:
100
101 Removing elements
102 #################
103
104 *To remove an element:*
105
106 .. |rme| image:: ../images/remove_elements_icon.png
107
108 #. Select your mesh in the Object Browser or in the 3D viewer.
109 #. From the **Modification** menu choose **Remove** and from the associated submenu select the **Elements**, or just click *"Remove elements"* button |rme| in the toolbar.
110
111    The following dialog box will appear:
112
113         .. image:: ../images/removeelements.png
114                 :align: center
115
116    In this dialog box you can specify one or several elements:
117
118    * choose mesh elements with the mouse in the 3D Viewer. It is possible to select a whole area with a mouse frame; or 
119    * input the element IDs directly in **ID Elements** field. The selected elements will be highlighted in the viewer; or
120    * apply Filters. **Set filter** button allows to apply a filter to the selection of elements. See more about filters in the :ref:`selection_filter_library_page` page.
121
122 #. Click **Apply** or **Apply and Close** to confirm deletion of the specified elements.
123
124 .. image:: ../images/remove_nodes1.png 
125         :align: center
126
127 .. centered::
128         The initial mesh
129
130 .. image:: ../images/remove_nodes2.png 
131         :align: center
132
133 .. centered::
134         The mesh with some elements removed
135
136
137 .. _clear_mesh_anchor:
138
139 Clearing Mesh Data
140 ##################
141
142 *To remove all nodes and all types of cells in your mesh at once:*
143
144 .. |clr| image:: ../images/mesh_clear.png
145
146 #. Select your mesh in the Object Browser or in the 3D viewer.
147 #. From the **Modification** menu choose **Remove** and from the associated submenu select the **Clear Mesh Data**, or just click *"Clear Mesh Data"* button |clr| in the toolbar. You can also right-click on the mesh in the Object Browser and select **Clear Mesh Data** in the pop-up menu.
148
149 .. note::
150    This command works in a different way in different situations: 
151                 * if the mesh is computed on a geometry, then *Clear Mesh Data* removes all elements and nodes.
152                 * if the mesh is not based on a geometry (imported, compound, created from scratch etc.), then *Clear Mesh Data* removes only the elements and nodes computed by algorithms. If no such elements or nodes have been created, can remove nothing.
153
154 **See Also** a sample TUI Script of a :ref:`tui_removing_nodes_and_elements` operation.  
155
156
157