3 \page creating_groups_page Creating groups
5 \n In MESH you can create a \ref grouping_elements_page "group" of
6 elements of a certain type. The main way to create a group, is to
7 select in the \b Mesh menu <b>Create Group</b> item (also available in
8 the context menu of the mesh).<br>
9 To create a group 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. The
26 chosen color is used to display the elements of the group.<br>
27 Activation of <em>Auto Color</em> item in mesh context menu
28 switches on a random choice of a color for a new group.</li>
30 Mesh module distinguishes between the three Group types:
31 <b>Standalone Group</b>, <b>Group on Geometry</b> and <b>Group on Filter</b>.
33 \anchor standalone_group <br><h2>"Standalone Group"</h2>
35 <b>Standalone Group</b> contains a list of mesh elements, which you can define in
38 <li>By adding all entities of the chosen type existing in the
39 mesh. For this, turn on the <b>Select All</b> check-box. In this mode
40 all controls, which allow selecting the entities, are
42 <li>By choosing entities manually with the mouse in the 3D Viewer. For
43 this, turn on the <b>Enable manual edition</b> check box. You can
44 click on an element in the 3D viewer and it will be highlighted. After
45 that click the \b Add button and the ID of this element will be
46 added to the list.<br>
47 The <b>Set filter</b> button allows to define the filter for
48 selection of the elements for your group. See more about filters on
49 the \ref selection_filter_library_page "Selection filter library"
51 <li>By adding entities from either a sub-mesh or another
52 group. For this, turn on the <b>Enable manual edition</b> check
53 box. <b>Select from</b> fields group allows to select a sub-mesh or
54 a group of the appropriate type and to \b Add their elements to the
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 selected 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 <b>See Also</b> a sample TUI Script of a
91 \ref tui_create_standalone_group "Create a Standalone Group"
95 \anchor group_on_geom <br><h2>"Group on Geometry"</h2>
97 To create a group on geometry check <b>Group on geometry</b> in the \b
98 Group \b type field. The group on geometry contains the elements
99 of a certain type generated on the selected geometrical object. Group
100 contents are dynamically updated if the mesh is modified. The group on
101 geometry can be created only if the mesh is based on geometry.
103 To define a group, click the \a Selection button and choose
104 - <em>Direct geometry selection</em> to select a shape in the Object
105 Browser or in the Viewer;
106 - <em>Find geometry by mesh element selection</em> to activate a
107 dialog which retrieves a shape by the selected element generated on
110 Note that this choice is available only if the mesh elements are
113 \image html a-creategroup.png
115 After confirmation of the operation a new group of mesh elements will
118 \image html image132.gif
119 <center>In this picture the cells which belong to a certain
120 geometrical face are selected in green.</center>
122 <b>See Also</b> a sample TUI Script of a
123 \ref tui_create_group_on_geometry "Create a Group on Geometry"
127 \anchor group_on_filter <br><h2>"Group on Filter"</h2>
129 To create a group on filter check <b>Group on filter</b> in the <b>
130 Group type</b> field. The group on filter contains the elements
131 of a certain type satisfying the defined filter. Group contents are
132 dynamically updated if the mesh is modified.
134 To define a group, click the <b>Set filter</b> button and define
135 criteria of the filter in the opened dialog. After the
136 operation is confirmed, a new group of mesh elements will be created. See more about
138 \ref selection_filter_library_page "Selection filter library" page.
140 \image html creategroup_on_filter.png
142 <b>See Also</b> a sample TUI Script of a
143 \ref tui_create_group_on_filter "Create a Group on Filter" operation.