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 \anchor standalone_group <br><h2>"Standalone Group"</h2>
  27
  28 <b>Standalone Group</b> consists of mesh elements, which you can define in
  29 the next 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 <li>By adding all existing entities of the chosen type to the
  40 group. For this purpose, it is necessary to turn on the <b>Select
  41 All</b> check box. In this mode, all controls which allow selection of
  42 the entities manually or by filters, are disabled.</li>
  43 </ul>
  44 To remove a selected element or elements from the list click the
  45 \b Remove button. The <b>Sort List</b> button allows to sort the list of IDs of
  46 mesh elements.
  47 \n <b>Select from</b> set of fields allows to choose a submesh or an existing
  48 group whose elements of the previously defined type will be added to
  49 the list of elements which will form the new group.
  50 \n <b>Color</b> - allows to assign to the group a certain color, for
  51 example, defining boundary conditions. This feature introduces a
  52 useful element of preprocessing in Mesh module. Note that <b>Color</b> attribute defines
  53 the colors used for the display of the elements of the group.
  54 \n <b>Warning</b> The Med Color group interface may change in future versions of Salome.
  55
  56 \image html creategroup.png
  57
  58 For example, to create a new group containing all entities of the
  59 existing group and some other faces selected in the viewer:
  60 <ul>
  61 <li> select the "Face" type of entities and input the name of the new group.</li>
  62 <li> checks "Group" checkbox in "Select From" group.</li>
  63 <li> select the existing group in the object browser or in the viewer.</li>
  64 <li> click "Add" in "Content" group. "Id Elements" list will be filled
  65 with IDs of faces belonging to the exising group.</li>
  66 <li> select other faces in the viewer.</li>
  67 <li> click "Apply" button to create the new group.</li>
  68 </ul>
  69
  70 Please note that the new group does not have references to the source
  71 group. It contains only the list of face IDs. So if the old group will
  72 be changed, the new one will not be modified.
  73
  74
  75 \image html image130.gif
  76 <center>In this picture the brown cells belong to a group defined manually.</center>
  77
  78 \image html image131.gif
  79 <center>In this picture the brown cells belong to the group defined by the criterion
  80 <b>Taper > 0</b>.</center>
  81
  82 <b>See Also</b> a sample TUI Script of a
  83 \ref tui_create_standalone_group "Create a Standalone Group"
  84 operation.
  85
  86 \anchor group_on_geom <br><h2>"Group on Geometry"</h2>
  87
  88 To create a group on geometry check <b>Group on geometry</b> in the \b Group
  89 \b type field. <b>Group on geometry</b> contains the elements of a certain type
  90 belonging to the selected geometrical object. To define a group select
  91 in the Objet Browser or in the 3D viewer a geometrical object from
  92 which the elements will be taken. After confirmation of the operation
  93 a new group of mesh elements will be created.
  94
  95 \image html a-creategroup.png
  96
  97 \image html image132.gif
  98 <center>In this picture the cells which belong to a certain face are
  99 selected in green.</center>
 100
 101 <b>See Also</b> a sample TUI Script of a
 102 \ref tui_create_group_on_geometry "Create a Group on Geometry"
 103 operation.
 104
 105 */