doc/salome/gui/SMESH/input/constructing_submeshes.doc

   1 /*!
   2
   3 \page constructing_submeshes_page Constructing sub-meshes
   4
   5 Sub-mesh is a mesh on a geometrical sub-object created with algorithms
   6 and/or hypotheses other than the algorithms and hypotheses assigned to
   7 the parent mesh on the parent object.
   8 <br><br>
   9 If a geometrical sub-object belongs to several geometrical objects
  10 having different meshes or sub-meshes, it will be meshed with the
  11 hypotheses of a sub-mesh of a lower dimension.<br>
  12 For example, a face of a box is meshed with a sub-mesh using algorithms
  13 and hypotheses other than the parent mesh on the whole box. The face
  14 and the box share four edges, which will be meshed with algorithms and
  15 hypotheses of the sub-mesh on the face, because the face is a 2D object
  16 while the box is a 3D object.  <br>
  17  If the dimensions are the same, an arbitrary algorithm/hypothesis
  18  will be used. This means that an edge shared by two faces each having
  19  its own different sub-mesh, will be meshed using algorithms and
  20  hypotheses of any of the two, chosen randomly. This indeterminacy can
  21  be fixed by defining \ref submesh_order_anchor "Sub-mesh priority".
  22 <br>
  23
  24 \n Construction of a sub-mesh consists of:
  25 <ul>
  26 <li>Selecting a mesh which will encapsulate your sub-mesh</li>
  27 <li>Selecting a geometrical object for meshing</li>
  28 <li>Applying one or several previously described
  29 \ref about_hypo_page "hypotheses" and
  30 \ref basic_meshing_algos_page "meshing algorithms" which will be used
  31 at computation of this sub-mesh</li>
  32 </ul>
  33
  34 <br><em>To construct a sub-mesh:</em>
  35 \par
  36 From the \b Mesh menu select <b>Create Sub-mesh</b> or click <em>"Create
  37 Sum-mesh"</em> button in the toolbar.
  38
  39 <center>
  40   \image html image33.gif
  41   <em>"Create Sub-mesh" button</em>
  42 </center>
  43
  44 \par
  45 The following dialog box will appear:
  46
  47 \par
  48 \image html createmesh-inv2.png
  49
  50 \par
  51 It allows to define the \b Name, the parent \b Mesh and the \b
  52 Geometry (e.g. a face if the parent mesh has been built on box) of the
  53 sub-mesh. You can define algorithms and hypotheses in the same way as
  54 in \ref constructing_meshes_page "Create mesh" menu.
  55
  56 \par
  57 If the parent mesh is already computed, then you can define
  58 \b Geometry by picking mesh elements computed on a sub-shape of interest
  59 in the 3D Viewer, i.e. you don't have to extract this sub-shape
  60 previously in Geometry module. To start element selection, press \a
  61 Selection button to the right of \b Geometry label. If this button is
  62 already down, then click it to release and then click it again. The
  63 following pop-up menu to choose a way of geometry definition will
  64 appear.
  65
  66 \par
  67 \image html choose_geom_selection_way.png
  68
  69 \par
  70 There the first item enables selecting the sub-shape in the Object
  71 Browser, the second one makes appear the following dialog.
  72
  73 \par
  74 \image html find_geom_by_mesh_elem.png
  75
  76 \par
  77 In this dialog, <b> Element Type </b> defines kind of element to pick in the
  78 Viewer. Instead of picking an element in the Viewer, you can type its
  79 ID in <b> Element ID</b> field. <b> Geometry name </b> allow you
  80 define a name of the sub-shape with which it will be published in the Study.
  81
  82
  83 \par
  84 In the Object Browser the structure of the new sub-mesh will be
  85 displayed as follows:
  86
  87 \image html image10.jpg
  88
  89 \par
  90 It contains:
  91 <ul>
  92 <li>a reference to the geometrical object on the basis of which the sub-mesh has been constructed;</li>
  93 <li><b>Applied hypotheses</b> folder containing the references to the
  94 hypotheses applied to the construction of the sub-mesh;</li>
  95 <li><b>Applied algorithms</b> folder containing the references to the
  96 algorithms applied to the construction of the sub-mesh.</li>
  97 </ul>
  98
  99 <br><b>See Also</b> a sample TUI Script of a
 100 \ref tui_construction_submesh "Construct Sub-mesh" operation.
 101
 102 */