3 \page creating_groups_page Creating groups
5 \n In MESH you can create a group of elements of a certain type. The
6 contents of the group can be defined in different ways. To create a group, in the \b
7 Mesh menu select <b>Create Group</b> item (also available in the
8 context menu of the mesh).<br>
9 To create a group of any type you should define the following:
11 <li><b>Mesh</b> - the mesh whose elements will form your
12 group. You can select your mesh in the Objet Browser or in the 3D
14 <li><b>Elements Type</b> - set of radio buttons allows to select the type of
15 elements which will form your group:</li>
18 <li><b>0D Element</b></li>
22 <li><b>Volumes</b></li>
24 <li><b>Name</b> field allows to enter the name of your new group.</li>
25 <li><b>Color</b> - allows to assign to the group a certain color, for
26 example, defining boundary conditions. The chosen color is used to
27 display the elements of the group. The color attribute of the group is
28 not persistent, it is lost if you save and then load the study from
31 SALOME Platform distinguishes between the three Group types:
32 <b>Standalone Group</b>, <b>Group on Geometry</b> and <b>Group on Filter</b>.
34 \anchor standalone_group <br><h2>"Standalone Group"</h2>
36 <b>Standalone Group</b> contains a list of mesh elements, which you can define in
39 <li>By adding all entities of the chosen type existing in the
40 mesh. For this, turn on the <b>Select All</b> check box. In this mode
41 all controls, which allow selecting the entities in other ways, are
43 <li>By choosing entities manually with the mouse in the 3D Viewer. For
44 this, turn on the <b>Enable manual edition</b> check box. You can
45 click on an element in the 3D viewer and it will be highlighted. After
46 that click the \b Add button and the ID of this element will be
47 added to the list.<br>
48 The <b>Set filter</b> button allows to define the filter for
49 selection of the elements for your group. See more about filters on
50 the \ref selection_filter_library_page "Selection filter library"
52 <li>By adding entities from either a sub-mesh or an existing
53 group. For this, turn on the <b>Enable manual edition</b> check
54 box. <b>Select from</b> set of fields allows to select a sub-mesh or
55 a group of the appropriate type.</li>
57 In the <b>manual edition</b> mode you can
59 <li>click the \b Remove button to remove the selected items from
61 <li>click the <b>Sort List</b> button to sort the list of IDs of
65 \image html creategroup.png
68 For example, to create a new group containing all faces of an
69 existing group and some other faces selected in the viewer:
71 <li> Select the \b Face type of entities and input the name of the new group.</li>
72 <li> Check the \b Group checkbox in <b>Select From</b> group.</li>
73 <li> Select the existing group of faces in the object browser or in the viewer</li>
74 <li> Click \b Add in \b Content group. <b>Id Elements</b> list will be filled
75 with IDs of faces belonging to the exising group.</li>
76 <li> Select other faces in the viewer.</li>
77 <li> Click \b Add in \b Content group.</li>
78 <li> Click \b Apply button to create the new group.</li>
81 Please note that the new group does not have references to the source
82 group. It contains only the list of face IDs. So if the source group
83 is changed, the new one is not updated accordingly.
86 \image html image130.gif
87 <center>In this picture the brown cells belong to a group defined
90 \image html image131.gif
91 <center>In this picture the brown cells belong to the group defined by
92 the criterion <b>Taper > 0</b>.</center>
94 <b>See Also</b> a sample TUI Script of a
95 \ref tui_create_standalone_group "Create a Standalone Group"
99 \anchor group_on_geom <br><h2>"Group on Geometry"</h2>
101 To create a group on geometry check <b>Group on geometry</b> in the \b
102 Group \b type field. The group on geometry contains the elements
103 of a certain type generated on the selected geometrical object. Group
104 contents are dynamically updated if the mesh is modified.<br>
105 To define a group, select in the Objet Browser or in the 3D viewer a
106 geometrical object from which the elements will be taken. After
107 confirmation of the operation a new group of mesh elements will be
110 \image html a-creategroup.png
112 \image html image132.gif
113 <center>In this picture the cells which belong to a certain
114 geometrical face are selected in green.</center>
116 <b>See Also</b> a sample TUI Script of a
117 \ref tui_create_group_on_geometry "Create a Group on Geometry"
121 \anchor group_on_filter <br><h2>"Group on Filter"</h2>
123 To create a group on filter check <b>Group on filter</b> in the <b>
124 Group type</b> field. The group on filter contains the elements
125 of a certain type satisfying the defined filter. Group contents are
126 dynamically updated if the mesh is modified.<br> To define a group,
127 click the <b>Set filter</b> button and define criteria of the
128 filter in the opened dialog. After confirmation of the operation a
129 new group of mesh elements will be created. See more about filters on
130 the \ref selection_filter_library_page "Selection filter library" page.
132 \image html creategroup_on_filter.png
134 <b>See Also</b> a sample TUI Script of a
135 \ref tui_create_group_on_filter "Create a Group on Filter" operation.