Salome HOME
dcbae8db4056b95ac68be47f352b383f4e82feb9
[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 <br>
27 For a group of edges, <b>Source</b> and <b>Target</b> vertices should be
28 shared by one edge of the group. If <b>Source</b> and <b>Target</b>
29 vertices are specified, the elements of the group must be adjacent.
30 The source and target groups must contain equal number of edges
31 and they must form topologically equal structures.
32
33 \n <b>Projection 2D</b> algorithm allows to define the mesh of a face
34 (or group of faces) by the
35 projection of another already meshed face (or group of faces). This
36 algorithm works only
37 if all edges of the target face have been meshed as 1D Projections of
38 the edges of the source face.
39
40 To apply this algorithm select the face to be meshed (indicated in the
41 field \b Geometry of <b>Create mesh</b> dialog box), <b>Projection
42 2D</b> in the list
43 of 2D algorithms and click the <em>"Add Hypothesis"</em> button. The
44 following dialog box will appear:
45
46 \image html projection_2d.png
47
48 In this menu you can define the \b Name of the algorithm, the already
49 meshed source \b Face and the \b Mesh (It can be omitted only when 
50 projecting a submesh on another one from the same global Mesh). 
51 It could also be necessary to define the orientation of mesh on the
52 face, which is done by indicating two <b>Source Vertices</b>, which
53 belong to the same edge of the source face, and two <b>Target
54 Vertices</b>, which belong to the same edge of the created \b Face.
55 For groups of face, they must contain equal number of faces
56 and they must form topologically equal structures.
57
58 \n <b>Projection 1D-2D</b> algorithm differs from <b>Projection 2D</b>
59 algorithm in one aspect: it generates mesh segments on edges of
60 the face according to the projected 2D elements; thus it does not
61 require the edges to be meshed by any other 1D algorithm; moreover it
62 does not allow to mesh edges of the face using another algorithm via
63 definition of sub-meshes.
64
65 \n <b>Projection 3D</b> algorithm allows to define the mesh of a shape by
66 the projection of another already meshed shape.  This algorithm works
67 only if all faces and edges of the target shape have been meshed as 1D-2D
68 Projections of the faces and edges of the source shape. Another
69 limitation is that this algorithm currently works only on boxes.
70
71 To apply this algorithm select the solid to be meshed (indicated in
72 the field \b Geometry of <b>Create mesh</b> dialog box), <b>Projection
73 3D</b> in the list of 3D algorithms and click the  button. The
74 following dialog box will appear:
75
76 \image html projection_3d.png
77
78 In this menu you can define the \b Name of the algorithm, the already
79 meshed source <b>3D shape</b> and the \b Mesh (It can be omitted only when 
80 projecting a submesh on another one from the same global Mesh). 
81 It could also be necessary to define the orientation of mesh on the shape, which is
82 done by indicating two <b>Source Vertices</b>, which belong to the same edge
83 of the source <b>3D Shape</b>, and two <b>Target Vertices</b>, which belong to the
84 same edge of the source <b>3D Shape</b>.
85
86 <br><b>See Also</b> a sample TUI Script of a 
87 \ref tui_projection "Projection Algorithms".
88
89 */
90