Salome HOME
Merge Python 3 porting.
[plugins/netgenplugin.git] / doc / salome / gui / NETGENPLUGIN / input / netgen_2d_3d_hypo.doc
1 /*!
2
3 \page netgen_2d_3d_hypo_page NETGEN 2D and 3D hypotheses
4
5 <b>NETGEN 2D Parameters</b> and <b>NETGEN 3D  Parameters</b> hypotheses work only with
6 <b>NETGEN 1D-2D</b>, <b>NETGEN 2D</b>, <b>NETGEN 1D-2D-3D</b> and
7 <b>NETGEN 3D</b> algorithms. <b>NETGEN 1D-2D</b> and <b>NETGEN
8 1D-2D-3D</b>  algorithms do not require definition of lower-level
9 hypotheses and algorithms (2D and 1D for meshing 3D objects and 1D for
10 meshing 2D objects).
11
12 \image html netgen2d3d.png
13 <center><em>Hypothesis dialog boxes of <b>NETGEN 1D-2D</b> and <b>NETGEN
14       1D-2D-3D</b> algorithms are same</em></center>
15 <br>
16
17 \image html netgen2d3d_only.png
18 <center><em>Dialog boxes of <b>NETGEN 2D</b> and <b>NETGEN 3D</b>
19     algorithms </em></center>
20
21 - <b>Name</b> - allows to define the name for the algorithm (NETGEN
22 2D (or 3D) Parameters by default).
23 - <b>Max Size</b> - maximum linear dimensions for mesh cells.
24 - <b>Min Size</b> - minimum linear dimensions for mesh cells. It is
25 ignored if it is more than <b>Max Size</b>.
26 - <b>Second Order</b> - if this box is checked in, the algorithm will
27 create second order mesh.
28 - <b>Fineness</b> - ranging from <em>Very Coarse</em> to <em>Very Fine</em>
29 allows to set the level of meshing detalization using the three
30 parameters below. You can select \a Custom to define them manually.
31 - <b>Growth rate</b> - allows to define how much the linear dimensions of
32 two adjacent cells can differ (e.g. 0.3 means 30%).
33 - <b>Nb. Segs per Edge</b> - allows to define the minimum number of
34 mesh segments in which edges will be split. This parameter is used
35 only if <b>Limit Size by Surface Curvature</b> is checked.
36 - <b>Nb Segs per Radius</b> - allows to define the size of
37 mesh segments and mesh faces in which curved edges and surfaces will
38 be split. This value divided by a radius of curvature gives an element
39 size at a given point. This parameter is used only if <b>Limit Size by
40   Surface Curvature</b> is checked.
41 - <b>Limit Size by Surface Curvature</b> - if this box is checked in,
42 then size of mesh segments and mesh faces on curved edges and surfaces
43 is defined using value of <b>Nb Segs per Radius</b> parameter, and
44 number of segments on straight edges is defined by values of
45 <b>Nb. Segs per Edge</b> parameter. (<b>Growth rate</b> is also taken
46 into account.) If this box is not checked in, then size of elements is
47 defined by three parameters only:
48 <b>Max Size</b>, <b>Min Size</b> and <b>Growth rate</b>.
49 - <b>Allow Quadrangles</b> - if this box is checked in, the mesher
50 tries to generate quadrangle 2D mesh. Triangle elements are created
51 where quadrangles are not possible.
52 - <b>Optimize</b> - if this box is checked in, the algorithm will modify
53 initially created mesh in order to improve quality of elements. Optimization
54 process is rather time consuming comparing to creation of initial mesh.
55 - <b>Fuse Coincident Nodes on Edges and Vertices</b> - allows merging
56 mesh nodes on vertices and edges which are geometrically coincident
57 but are topologically different.
58
59 \image html netgen3d_local_size.png
60
61 - <b>Local sizes</b> - allows to define size of elements on and
62 around specified geometrical objects. To define the local
63 size it is necessary to select a geometrical objects in the
64 object browser or in the viewer, and to click a button corresponding
65 to the type of the geometrical objects: <b>On Vertex</b>, <b>On
66   Edge</b> etc. <b>Name</b> of the geometrical object and a
67 default <b>Value</b> will be added in the table where the <b>Value</b>
68 can be changed.
69 - <b>Remove</b> - deletes a selected row from the table.
70 - <b>Mesh-size File</b> - opens a dialog to select a file defining
71 size of elements. The file includes two obligatory sections. The first
72 section defines the size at points. The second section defines the
73 size along lines. Let's consider the following sample size file.
74 \code
75 2
76 92.5 92.5 92.5 0.05
77 42.5 42.5 42.5 0.04
78 1
79 25 25 0 25 25 200  0.3
80 \endcode
81 "2" at the first line means that there are two points in the first
82 section.<br>
83 "92.5 92.5 92.5 0.05" at the second line means that at the point with
84 coordinates (92.5, 92.5, 92.5) size of elements should be 0.05.<br>
85 "1" at the fourth line means that there is one line in the second
86 section.<br>
87 "25 25 0 25 25 200  0.3" means that along the line between points (25,
88 25, 0) and (25, 25, 200) size of elements should be 0.3.
89
90 \image html netgen2d3d_simple.png
91
92 <b>NETGEN 2D simple parameters</b> and <b>NETGEN 3D simple
93 parameters</b> allow defining the size of elements for each
94 dimension.
95
96 \b 1D group allows defining the size of 1D elements in either of two ways: 
97 - <b>Number of Segments</b> allows specifying number of segments, that
98 will split each edge, with equidistant distribution.
99 - <b>Local Length</b> defines length of segments.
100
101 \b 2D group allows defining the size of 2D elements 
102 - <b>Length from edges</b> if checked in, size of 
103 2D mesh elements is defined as an average mesh segment length
104 for a given wire, else
105 - <b>Max. Element Area</b> specifies expected maximum element area for
106 each 2d element.
107 - <b>Allow Quadrangles</b> - allows to generate quadrangle elements
108 wherever possible.
109
110 \b 3D groups allows defining the size of 3D elements.
111 - <b>Length from faces</b> if checked in, the area of sides of
112 volumic elements will be equal to an average area of 2D elements, else
113 - <b>Max. Element Volume</b> specifies expected maximum element volume
114 of 3d elements.
115
116 \note NETGEN algorithm does not strictly follow the input
117 parameters. The actual mesh can be more or less dense than
118 required. There are several factors in it:
119 - NETGEN does not actually use <b>Number of Segments</b> parameter for
120 discretization of edge. This parameter is used  only to define the
121 local element size (size at the given point), so local sizes of
122 close edges influence each other.
123 - NETGEN additionally restricts the element size according to edge curvature.
124 - The local size of segments influences the size of close triangles.
125 - The order of elements and their size in the 1D mesh generated by
126 NETGEN differ from those in the 1D mesh generated by Regular_1D
127 algorithm, resulting in different 2D and 3D meshes.
128
129 */