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 geometrical object.
   8
   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". The
  22  default sub-meshes priority is such that multi-dimensional algorithms
  23  are processed first.
  24 <br>
  25
  26 \n Construction of a sub-mesh consists of:
  27 <ul>
  28 <li>Selecting a mesh which will encapsulate your sub-mesh</li>
  29 <li>Selecting a geometrical object for meshing</li>
  30 <li>Applying one or several previously described
  31 \ref about_hypo_page "hypotheses" and
  32 \ref basic_meshing_algos_page "meshing algorithms" which will be used
  33 at computation of this sub-mesh</li>
  34 </ul>
  35
  36 <br><em>To construct a sub-mesh:</em>
  37 \par
  38 From the \b Mesh menu select <b>Create Sub-mesh</b> or click <em>"Create
  39 Sum-mesh"</em> button in the toolbar.
  40
  41 <center>
  42   \image html image33.gif
  43   <em>"Create Sub-mesh" button</em>
  44 </center>
  45
  46 \par
  47 The following dialog box will appear:
  48
  49 \par
  50 \image html createmesh-inv2.png
  51
  52 \par
  53 It allows to define the \b Name, the parent \b Mesh and the \b
  54 Geometry (e.g. a face if the parent mesh has been built on box) of the
  55 sub-mesh. You can define algorithms and hypotheses in the same way as
  56 in \ref constructing_meshes_page "Create mesh" menu.
  57
  58 \par
  59 If the parent mesh is already computed, then you can define the
  60 \b Geometry by picking mesh elements computed on a sub-shape of interest
  61 in the 3D Viewer, i.e. you do not have to extract this sub-shape
  62 in Geometry module beforehand. To start element selection, press \a
  63 Selection button to the right of \b Geometry label. If this button is
  64 already down, then click it to release and then click it again. The
  65 following pop-up menu allowing to choose a way of geometry definition will
  66 appear.
  67
  68 \par
  69 \image html choose_geom_selection_way.png
  70
  71 \par
  72 <b>Direct geometry selection</b> enables selecting the sub-shape in the Object
  73 Browser.
  74 <b>Find geometry by mesh element selection</b> activates the following dialog.
  75
  76 \par
  77 \image html find_geom_by_mesh_elem.png
  78
  79 \par
  80 In this dialog, <b> Element Type </b> defines kind of element to pick in the
  81 Viewer.
  82 Instead of picking an element in the Viewer, you can type its
  83 ID in <b> Element ID</b> field.
  84 <b> Geometry name </b> field allows defining a name of the sub-shape.
  85
  86
  87 \par
  88 In the Object Browser the structure of the new sub-mesh will be
  89 displayed as follows:
  90
  91 \image html image10.jpg
  92
  93 \par
  94 It contains:
  95 <ul>
  96 <li>a reference to the geometrical object on the basis of which the sub-mesh has been constructed;</li>
  97 <li><b>Applied hypotheses</b> folder containing the references to the
  98 hypotheses applied to the construction of the sub-mesh;</li>
  99 <li><b>Applied algorithms</b> folder containing the references to the
 100 algorithms applied to the construction of the sub-mesh.</li>
 101 </ul>
 102
 103 <br><b>See Also</b> a sample TUI Script of a
 104 \ref tui_construction_submesh "Construct Sub-mesh" operation.
 105
 106 */