X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fcreating_groups.doc;h=da12c8337b6b5472b33fde063a5ca0b338cbc534;hb=8682ebb1ebbf9c8392c8fa4adcce76d37e171859;hp=34643a7b2c3eaa34f2c2ce20267672de696607cc;hpb=707703a9f4b4c39646188de02d51357e1d8dd577;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/creating_groups.doc b/doc/salome/gui/SMESH/input/creating_groups.doc
index 34643a7b2..da12c8337 100644
--- a/doc/salome/gui/SMESH/input/creating_groups.doc
+++ b/doc/salome/gui/SMESH/input/creating_groups.doc
@@ -2,11 +2,11 @@
\page creating_groups_page Creating groups
-\n In MESH you can create a group of elements of a certain type. The
-contents of the group can be defined in different ways. To create a group, in the \b
-Mesh menu select Create Group item (also available in the
-context menu of the mesh).
-To create a group of any type you should define the following:
+\n In MESH you can create a \ref grouping_elements_page "group" of
+elements of a certain type. The main way to create a group, is to
+select in the \b Mesh menu Create Group item (also available in
+the context menu of the mesh).
+To create a group you should define the following:
- Mesh - the mesh whose elements will form your
group. You can select your mesh in the Objet Browser or in the 3D
@@ -22,13 +22,12 @@ elements which will form your group:
- Volumes
Name field allows to enter the name of your new group.
-Color - allows to assign to the group a certain color, for
-example, defining boundary conditions. The chosen color is used to
-display the elements of the group. The color attribute of the group is
-not persistent, it is lost if you save and then load the study from
-the file.
+Color - allows to assign to the group a certain color. The
+ chosen color is used to display the elements of the group.
+ Activation of Auto Color item in mesh context menu
+ switches on a random choice of a color for a new group.
-SALOME Platform distinguishes between the three Group types:
+Mesh module distinguishes between the three Group types:
Standalone Group, Group on Geometry and Group on Filter.
\anchor standalone_group
"Standalone Group"
@@ -37,8 +36,8 @@ SALOME Platform distinguishes between the three Group types:
the following ways:
- By adding all entities of the chosen type existing in the
- mesh. For this, turn on the Select All check box. In this mode
- all controls, which allow selecting the entities in other ways, are
+ mesh. For this, turn on the Select All check-box. In this mode
+ all controls, which allow selecting the entities, are
disabled.
- By choosing entities manually with the mouse in the 3D Viewer. For
this, turn on the Enable manual edition check box. You can
@@ -49,10 +48,11 @@ the following ways:
selection of the elements for your group. See more about filters on
the \ref selection_filter_library_page "Selection filter library"
page.
-- By adding entities from either a sub-mesh or an existing
- group. For this, turn on the Enable manual edition check
- box. Select from set of fields allows to select a sub-mesh or
- a group of the appropriate type.
+- By adding entities from either a sub-mesh or another
+ group. For this, turn on the Enable manual edition check
+ box. Select from fields group allows to select a sub-mesh or
+ a group of the appropriate type and to \b Add their elements to the
+ group.
In the manual edition mode you can
@@ -70,9 +70,9 @@ existing group and some other faces selected in the viewer:
- Select the \b Face type of entities and input the name of the new group.
- Check the \b Group checkbox in Select From group.
-- Select the existing group of faces in the object browser or in the viewer
+- Select the existing group of faces in the object browser or in the viewer.
- Click \b Add in \b Content group. Id Elements list will be filled
-with IDs of faces belonging to the exising group.
+with IDs of faces belonging to the selected group.
- Select other faces in the viewer.
- Click \b Add in \b Content group.
- Click \b Apply button to create the new group.
@@ -87,10 +87,6 @@ is changed, the new one is not updated accordingly.
In this picture the brown cells belong to a group defined
manually.
-\image html image131.gif
-In this picture the brown cells belong to the group defined by
- the criterion Taper > 0.
-
See Also a sample TUI Script of a
\ref tui_create_standalone_group "Create a Standalone Group"
operation.
@@ -101,14 +97,24 @@ operation.
To create a group on geometry check Group on geometry in the \b
Group \b type field. The group on geometry contains the elements
of a certain type generated on the selected geometrical object. Group
-contents are dynamically updated if the mesh is modified.
-To define a group, select in the Objet Browser or in the 3D viewer a
-geometrical object from which the elements will be taken. After
-confirmation of the operation a new group of mesh elements will be
-created.
+contents are dynamically updated if the mesh is modified. The group on
+geometry can be created only if the mesh is based on geometry.
+
+To define a group, click the \a Selection button and choose
+- Direct geometry selection to select a shape in the Object
+ Browser or in the Viewer;
+- Find geometry by mesh element selection to activate a
+ dialog which retrieves a shape by the selected element generated on
+ this shape.
+
+Note that this choice is available only if the mesh elements are
+already generated.
\image html a-creategroup.png
+After confirmation of the operation a new group of mesh elements will
+be created.
+
\image html image132.gif
In this picture the cells which belong to a certain
geometrical face are selected in green.
@@ -123,11 +129,13 @@ operation.
To create a group on filter check Group on filter in the
Group type field. The group on filter contains the elements
of a certain type satisfying the defined filter. Group contents are
-dynamically updated if the mesh is modified.
To define a group,
-click the Set filter button and define criteria of the
-filter in the opened dialog. After confirmation of the operation a
-new group of mesh elements will be created. See more about filters on
-the \ref selection_filter_library_page "Selection filter library" page.
+dynamically updated if the mesh is modified.
+
+To define a group, click the Set filter button and define
+criteria of the filter in the opened dialog. After the
+operation is confirmed, a new group of mesh elements will be created. See more about
+filters on the
+\ref selection_filter_library_page "Selection filter library" page.
\image html creategroup_on_filter.png