doc/salome/gui/SMESH/input/creating_groups.doc

   1 /*!
   2
   3 \page creating_groups_page Creating groups
   4
   5 \n In MESH you can create groups of elements of different types. To
   6 create a group of elements in the \b Mesh menu select <b>Create
   7 Group</b>.
   8 \n To create any group you should define the following:
   9 <ul>
  10 <li><b>Mesh</b> - the name of the mesh whose elements will form your
  11 group. You can select your mesh in the Objet Browser or in the 3D
  12 viewer.</li>
  13 <li><b>Elements Type</b> - set of radio buttons allows to select the type of
  14 elements which will form your group:</li>
  15 <ul>
  16 <li><b>Nodes</b></li>
  17 <li><b>Edges</b></li>
  18 <li><b>Faces</b></li>
  19 <li><b>Volumes</b></li>
  20 </ul>
  21 <li><b>Name</b> field allows to enter the name of your new group.</li>
  22 </ul>
  23 SALOME Platform distinguishes between the two Group types:
  24 <b>Standalone Group</b> and <b>Group on Geometry</b>.
  25
  26 <br><h2>Standalone Group</h2>
  27
  28 <b>Standalone Group</b> consists of mesh elements, which you can define in
  29 two possible ways.
  30 <ul>
  31 <li>Choosing them manually with the mouse in the 3D Viewer. You can
  32 click on an element in the 3D viewer and it will be highlighted. After
  33 that click the \b Add button and the ID of this element will be added to
  34 the list.</li>
  35 <li>Applying Filters. The <b>Set filter</b> button allows to apply a
  36 definite filter to selection of the elements of your group. See more
  37 about filters on the
  38 \ref selection_filter_library_page "Selection filter library" page.</li>
  39 </ul>
  40 To remove a selected element or elements from the list click the
  41 \b Remove button. The <b>Sort List</b> button allows to sort the list of IDs of
  42 mesh elements.
  43 \n <b>Select from</b> set of fields allows to choose a submesh or an existing
  44 group whose elements of the previously defined type will be added to
  45 the list of elements which will form your group.
  46 \n <b>Color</b> - allows to assign to the group a certain color, for
  47 example, defining boundary conditions. This feature introduces a
  48 useful element of preprocessing in Mesh module. Note that <b>Color</b> attribute defines
  49 the colors used for the display of the elements of the group.
  50 \n <b>Warning</b> The Med Color group interface may change in future versions of Salome.
  51
  52
  53 \image html creategroup.png
  54
  55 \image html image130.gif
  56 <center>In this picture the brown cells belong to a group defined manually.</center>
  57
  58 \image html image131.gif
  59 <center>In this picture the brown cells belong to the group defined by the criterion
  60 <b>Taper > 0</b>.</center>
  61
  62 <b>See Also</b> a sample TUI Script of a
  63 \ref tui_create_standalone_group "Create a Standalone Group"
  64 operation.
  65
  66 <br><h2>Group on Geometry</h2>
  67
  68 To create a group on geometry check <b>Group on geometry</b> in the \b Group
  69 \b type field. <b>Group on geometry</b> contains the elements of a certain type
  70 belonging to the selected geometrical object. To define a group select
  71 in the Objet Browser or in the 3D viewer a geometrical object from
  72 which the elements will be taken. After confirmation of the operation
  73 a new group of mesh elements will be created.
  74
  75 \image html a-creategroup.png
  76
  77 <br><br>
  78 To create multiple groups on geometry of both nodes and elements of
  79 any type at once, in the \b Mesh menu select <b>Create Groups from
  80 Geometry</b>.<br>
  81 Group names are same as those of geometrical objects.
  82 Type of group of mesh elements is defined automatically by
  83 <b>Geometrical object</b> nature.
  84
  85 \image html create_groups_from_geometry.png
  86
  87 \image html image132.gif
  88 <center>In this picture the cells which belong to a certain face are
  89 selected in green.</center>
  90
  91 <b>See Also</b> a sample TUI Script of a
  92 \ref tui_create_group_on_geometry "Create a Group on Geometry"
  93 operation.
  94
  95 <br><h2>Creation of groups using existing groups and sub-meshes.</h2>
  96
  97 Application provides possibility to create new <b>standalone</b> groups using existing standalone groups, groups on geometry and sub-meshes. This functionality is implemented using "Select from" group box of "Create group" dialog box described above.
  98
  99 This functionality is described on the example of creating new group   from existing standalone groups and groups on geometry.
 100
 101 Imagine there are group G1. It can be standalone group or group on geometry.
 102
 103 To create group G2 containing all entities of group G1 and a faces graphically selected in 3D view following steps can be performed:
 104 <ul>
 105 <li>User opens "Create group" dialog box.</li>
 106 <li>The user specifies "Face" type of entities and "G2" name of group.</li>
 107 <li>The user checks "Group" check-box of "Select From" group box.</li>
 108 <li>The user selects G1 group in object browser or 3D view.</li>
 109 <li>The user presses "Add" push button of "Content" group box. "Id Elements" list-box is filled with identifiers of faces belonging to group G1.</li>
 110 <li>The user selects other faces in 3D view.</li>
 111 <li>The user presses "Apply" button. System creates group G2.</li>
 112 </ul>
 113
 114 Please note that group G2 does not have a references to source group G1. It contains list of faces identifiers only. So if G1 group will be changed group G2 will remain unmodified.
 115
 116 <br>
 117 \anchor gui_create_dim_group
 118 <h2>Creating groups of entities from existing groups of superior dimensions</h2>
 119
 120 Application provides possibility for creating groups of entities from existing groups of superior dimensions. For example, it is possible to create group of nodes using list of existing groups of faces.
 121
 122 To create groups of entities from existing groups of superior dimensions, in the \b Mesh menu select <b>Group of underlying entities</b>.<br>
 123
 124 The following dialog box will appear:
 125
 126 \image html dimgroup_dlg.png
 127
 128 In this dialog box you should specify the name of the resulting group, types of entities and set of source groups.
 129
 130 For example, we have two source Volume groups illustrated on the figure below
 131
 132 \image html dimgroup_src.png
 133 <center>Source groups</center>
 134
 135 In this case we obtain following results for Faces, Edges and Nodes.
 136
 137 \image html dimgroup_2d.png
 138 <center>Faces</center>
 139
 140 \image html dimgroup_1d.png
 141 <center>Edges</center>
 142
 143 \image html dimgroup_0d.png
 144 <center>Nodes</center>
 145
 146 <b>See Also</b> a sample TUI Script of a
 147 \ref tui_create_dim_group "Creating groups of entities from existing groups of superior dimensions"
 148 operation.
 149 */