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 (sub-shape) used to assign
   6 different meshing algorithms and/or hypotheses than the algorithms and
   7 hypotheses assigned to the parent mesh on the parent geometrical
   8 object, that allows getting a local mesh refinement.
   9
  10 A sub-shape to create a sub-mesh on should be retrieved from the shape
  11 of the parent mesh in one of the following ways: <ul>
  12 <li> In Geometry module, via <em>New Entity > Explode</em> menu.</li>
  13 <li> In Geometry module, by creation of a group (<em>New Entity >
  14     Group > Create Group</em> menu).</li>
  15 <li> In Mesh module, by
  16   \ref subshape_by_mesh_elem "selecting a mesh element" generated on a
  17   sub-shape of interest. This way is accessible if the mesh is
  18   already computed.</li>
  19 </ul>
  20
  21 If a geometrical sub-object belongs to several geometrical objects
  22 having different meshes or sub-meshes, it will be meshed with the
  23 hypotheses of a sub-mesh of a lower dimension.<br>
  24 For example, a face of a box is meshed with a sub-mesh using algorithms
  25 and hypotheses other than the parent mesh on the whole box. The face
  26 and the box share four edges, which will be meshed with algorithms and
  27 hypotheses of the sub-mesh on the face, because the face is a 2D object
  28 while the box is a 3D object.  <br>
  29  If the dimensions are the same, an arbitrary algorithm/hypothesis
  30  will be used. This means that an edge shared by two faces each having
  31  its own different sub-mesh, will be meshed using algorithms and
  32  hypotheses of any of the two, chosen randomly. This indeterminacy can
  33  be fixed by defining \ref submesh_order_anchor "Sub-mesh priority". The
  34  default sub-meshes priority is such that multi-dimensional algorithms
  35  are processed first.
  36 <br>
  37
  38 \n Construction of a sub-mesh consists of:
  39 <ul>
  40 <li>Selecting a mesh which will encapsulate your sub-mesh</li>
  41 <li>Selecting a geometrical object for meshing</li>
  42 <li>Applying one or several previously described
  43 \ref about_hypo_page "hypotheses" and
  44 \ref basic_meshing_algos_page "meshing algorithms" which will be used
  45 at computation of this sub-mesh</li>
  46 </ul>
  47
  48 <br><em>To construct a sub-mesh:</em>
  49 \par
  50 From the \b Mesh menu select <b>Create Sub-mesh</b> or click <em>"Create
  51 Sum-mesh"</em> button in the toolbar.
  52
  53 <center>
  54   \image html image33.gif
  55   <em>"Create Sub-mesh" button</em>
  56 </center>
  57
  58 \par
  59 The following dialog box will appear:
  60
  61 \par
  62 \image html createmesh-inv2.png
  63
  64 \par
  65 It allows to define the \b Name, the parent \b Mesh and the \b
  66 Geometry (e.g. a face if the parent mesh has been built on box) of the
  67 sub-mesh. You can select meshing algorithms and hypotheses in the same way as
  68 in \ref constructing_meshes_page "Create mesh" menu.
  69
  70 \par
  71 \anchor subshape_by_mesh_elem
  72 If the parent mesh is already computed, then you can define the
  73 \b Geometry by picking mesh elements computed on a sub-shape of interest
  74 in the 3D Viewer, i.e. you do not have to extract this sub-shape
  75 in Geometry module beforehand. To start element selection, press \a
  76 Selection button to the right of \b Geometry label. If this button is
  77 already down, then click it to release and then click it again. The
  78 following pop-up menu allowing to choose a way of geometry definition will
  79 appear.
  80
  81 \par
  82 \image html choose_geom_selection_way.png
  83
  84 \par
  85 <b>Direct geometry selection</b> enables selecting the sub-shape in the Object
  86 Browser.
  87 <b>Find geometry by mesh element selection</b> activates the following dialog.
  88
  89 \par
  90 \image html find_geom_by_mesh_elem.png
  91
  92 \par
  93 In this dialog, <b> Element Type </b> defines a kind of element to pick in the
  94 Viewer.
  95 Instead of picking an element in the Viewer, you can type its
  96 ID in <b> Element ID</b> field.
  97 <b> Geometry name </b> field allows defining a name of the sub-shape,
  98 with which the sub-shape will appear in the Object Browser (if not yet
  99 there).
 100
 101 \par
 102 In the Object Browser the structure of the new sub-mesh will be
 103 displayed as follows:
 104
 105 \image html image10.jpg
 106
 107 \par
 108 It contains:
 109 <ul>
 110 <li>a sub-mesh name (\a SubMeshFace1)
 111 <li>a reference to the geometrical object on the basis of which the
 112   sub-mesh has been constructed (<em>Cylindrical Face_1</em>);</li>
 113 <li><b>Applied hypotheses</b> folder containing the references to the
 114 hypotheses selected at the construction of the sub-mesh;</li>
 115 <li><b>Applied algorithms</b> folder containing the references to the
 116 algorithms selected at the construction of the sub-mesh.</li>
 117 </ul>
 118
 119 <br><b>See Also</b> a sample TUI Script of a
 120 \ref tui_construction_submesh "Construct Sub-mesh" operation.
 121
 122 */