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