Salome HOME
RNC: Unaccuracy of projection algos documentation has been fixes
[modules/smesh.git] / doc / salome / gui / SMESH / input / projection_algos.doc
1 /*!
2
3 \page projection_algos_page Projection Algorithms
4
5 \n Projection algorithms allow to define the mesh of a geometrical
6 object by the projection of another already meshed geometrical object.
7
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
14 <em>"Add Hypothesis"</em> button.
15 The following dialog box will appear:
16
17 \image html projection_1d.png
18
19 In this menu you can define the \b Name of the algorithm, the already
20 meshed source \b Edge and the \b Mesh  (It can be omitted only when 
21 projecting a submesh on another one from the same global Mesh). 
22 It could also be necessary to define the orientation of edges, 
23 which is done by indicating the <b>Source Vertex</b> being the first point 
24 of the Source Edge and the <b>Target Vertex</b> being the first point of 
25 the created \b Edge. 
26 For a group of edges, <b>Source</b> and <b>Target</b> vertices should be
27 shared by only one edge of the group. If <b>Source</b> and
28 <b>Target</b> vertices are specified, the elements of the group must be ajacent.
29
30 \n <b>Projection 2D</b> algorithm allows to define the mesh of a face
31 (or group of faces) by the
32 projection of another already meshed face (or group of faces). This
33 algorithm works only
34 if all edges of the target face have been meshed as 1D Projections of
35 the edges of the source face.
36
37 To apply this algorithm select the face to be meshed (indicated in the
38 field \b Geometry of <b>Create mesh</b> dialog box), <b>Projection
39 2D</b> in the list
40 of 2D algorithms and click the <em>"Add Hypothesis"</em> button. The
41 following dialog box will appear:
42
43 \image html projection_2d.png
44
45 In this menu you can define the \b Name of the algorithm, the already
46 meshed source \b Face and the \b Mesh (It can be omitted only when 
47 projecting a submesh on another one from the same global Mesh). 
48 It could also be necessary to define the orientation of mesh on the face
49 , which is done by indicating two <b>Source Vertices</b>, which belong 
50 to the same edge of the source face, and two <b>Target Vertices</b>, which 
51 belong to the same edge of the created \b Face.
52
53 \n <b>Projection 3D</b> algorithm allows to define the mesh of a shape by
54 the projection of another already meshed shape.  This algorithm works
55 only if all faces and edges of the target shape have been meshed as 1D-2D
56 Projections of the faces and edges of the source shape. Another
57 limitation is that this algorithm currently works only on boxes.
58
59 To apply this algorithm select the solid to be meshed (indicated in
60 the field \b Geometry of <b>Create mesh</b> dialog box), <b>Projection
61 3D</b> in the list of 3D algorithms and click the  button. The
62 following dialog box will appear:
63
64 \image html projection_3d.png
65
66 In this menu you can define the \b Name of the algorithm, the already
67 meshed source <b>3D shape</b> and the \b Mesh (It can be omitted only when 
68 projecting a submesh on another one from the same global Mesh). 
69 It could also be necessary to define the orientation of mesh on the shape, which is
70 done by indicating two <b>Source Vertices</b>, which belong to the same edge
71 of the source <b>3D Shape</b>, and two <b>Target Vertices</b>, which belong to the
72 same edge of the source <b>3D Shape</b>.
73
74 <br><b>See Also</b> a sample TUI Script of a 
75 \ref tui_projection "Projection Algorithms".
76
77 */
78