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

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