doc/salome/gui/SMESH/input/projection_algos.rst

   1 .. _projection_algos_page:
   2
   3 *********************
   4 Projection Algorithms
   5 *********************
   6
   7 .. contents:: `Table of contents`
   8
   9 Projection algorithms allow to define the mesh of a geometrical
  10 object by the projection of another already meshed geometrical object.
  11
  12 .. note::
  13         Source and target geometrical objects mush be topologically equal, i.e. they must have same number of sub-shapes, connected to corresponding counterparts.
  14
  15 .. image:: ../images/topo_equality.png
  16         :align: center
  17
  18 .. centered::
  19         Topologically equal faces suitable for 2D projection.
  20
  21
  22 .. _projection_1D:
  23
  24 Projection 1D
  25 =============
  26
  27 **Projection 1D** algorithm allows to define the mesh of an edge (or group of edges)
  28 by the projection of another already meshed edge (or group of edges).
  29
  30 To apply this algorithm select the edge to be meshed (indicated in
  31 the field **Geometry** of **Create mesh** dialog box),
  32 **Projection1D** in the list of 1D algorithms and click the
  33 *"Add Hypothesis"* button.
  34 The following dialog box will appear:
  35
  36 .. image:: ../images/projection_1d.png
  37         :align: center
  38
  39 In this dialog you can define
  40
  41 * the **Name** of the algorithm,
  42 * the already meshed **Source Edge** and
  43 * the **Source Mesh** (It can be omitted only when projecting a sub-mesh on another one of the same Mesh).
  44 * It could also be necessary to define the orientation of edges,  which is done by indicating the **Source Vertex** being the first point of the **Source Edge** and the **Target Vertex** being the first point of the edge being meshed.
  45
  46
  47 For a group of edges, **Source** and **Target** vertices should be
  48 shared by only one edge of the group. If **Source** and **Target**
  49 vertices are specified, the edges in the group must be connected.
  50 The source and target groups must contain equal number of edges
  51 and they must form topologically equal structures.
  52
  53 .. _projection_2D:
  54
  55 Projection 2D
  56 =============
  57
  58
  59 **Projection 2D** algorithm allows to define the mesh of a face
  60 (or group of faces) by the projection of another already meshed face
  61 (or group of faces). This algorithm works only if all edges of the
  62 target face have been discretized into the same number of
  63 segments as corresponding edges of the source face.
  64
  65 To apply this algorithm select the face to be meshed (indicated in the
  66 field **Geometry** of **Create mesh** dialog box), **Projection
  67 2D** in the list of 2D algorithms and click the *"Add Hypothesis"* button. The following dialog box will appear:
  68
  69 .. image:: ../images/projection_2d.png
  70         :align: center
  71
  72 In this dialog you can define
  73
  74 * the **Name** of the algorithm,
  75 * the already meshed **Source Face** and
  76 * the **Source Mesh** (It can be omitted only when projecting a submesh on another one of the same Mesh).
  77 * It could also be necessary to define the orientation of mesh on the face, which is done by indicating two **Source Vertices**, which belong to the same edge of the **Source Face**, and two **Target Vertices**, which belong to the same edge of the face being meshed.
  78
  79
  80 The groups of faces are suitable for this algorithm only if they
  81 contain an equal number of faces and form topologically equal
  82 structures.
  83
  84 .. _projection_1D2D:
  85
  86 Projection 1D-2D
  87 ================
  88
  89 **Projection 1D-2D** algorithm differs from
  90 :ref:`projection_2D` algorithm in one aspect: it generates mesh segments
  91 on edges of the face according to the projected 2D elements; thus it
  92 does not require the edges to be meshed by any other 1D algorithm;
  93 moreover it does not allow to mesh edges of the face using another
  94 algorithm via definition of sub-meshes.
  95
  96
  97 .. _projection_3D:
  98
  99 Projection 3D
 100 =============
 101
 102 **Projection 3D** algorithm allows to define the mesh of a shape by
 103 the projection of another already meshed shape.  This algorithm works
 104 only if all faces and edges of the target shape have been meshed as 1D-2D
 105 Projections of the faces and edges of the source shape. Another
 106 limitation is that this algorithm currently works only on boxes.
 107
 108 To apply this algorithm select the solid to be meshed (indicated in
 109 the field **Geometry** of **Create mesh** dialog box), **Projection 3D**
 110 in the list of 3D algorithms and click the  button. The
 111 following dialog box will appear:
 112
 113 .. image:: ../images/projection_3d.png
 114         :align: center
 115
 116 In this menu you can define the **Name** of the algorithm, the already
 117 meshed source **3D shape** and the **Mesh** (It can be omitted only when
 118 projecting a submesh on another one from the same global Mesh).
 119 It could also be necessary to define the orientation of mesh on the shape, which is
 120 done by indicating two **Source Vertices**, which belong to the same edge
 121 of the source **3D Shape**, and two **Target Vertices**, which belong to the
 122 same edge of the source **3D Shape**.
 123
 124 **See Also** a sample TUI Script of a
 125 :ref:`tui_projection`.
 126
 127
 128