Salome HOME
Fixed documentation for Python package (opens in a new window)
[modules/smesh.git] / doc / salome / gui / SMESH / 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>Dialog boxes of <b>Netgen 1D-2D</b> and <b>Netgen
14 1D-2D-3D</b> algorithms </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>Second Order</b> - if this box is checked in, the algorithm will
25 create second order nodes on the mesh, which actually will become
26 \ref adding_quadratic_elements_page "Quadratic".
27 - <b>Fineness</b> - ranging from Very Coarse to Very Fine allows to set the
28 level of meshing detalization using the three parameters below. You
29 can select Custom to define them manually.
30 - <b>Growth rate</b> - allows to define how much the linear dimensions of
31 two adjacent cells can differ (i.e. 0.3 means 30%).
32 - <b>Nb. Segs per Edge</b> and <b>Nb Segs per Radius</b> - allows to define the
33 minimum number of mesh segments in which edges and radiuses will be
34 split.
35 - <b>Allow Quadrangles</b> - allows to use quadrangle elements in a
36 triangle 2D mesh. This checkbox is not present in Netgen 3D parameters
37 because currently building a tetrahedral mesh with quadrangle faces is
38 not possible.
39 - <b>Optimize</b> - if this box is checked in, the algorithm will try to
40 create regular (possessing even sides) elements.
41
42 \image html netgen3d_local_size.png
43
44 - <b>Local sizes</b> - allows to define size of elements on and
45 around specified geometrical edges and vertices. To define the local
46 size it is necessary to select a geometrical edge or vertex in the
47 object browser or in the viewer, and to click <b>On Edge</b> or <b>On
48 Vertex</b> correspondingly. <b>Name</b> of the geometrical object and
49 a default <b>Value</b> will be added in the table where the
50 <b>Value</b> can be changed.
51 - <b>Remove</b> - deletes a selected row from the table.
52
53 \image html netgen2d3d_simple.png
54
55 <b>Netgen 2D simple parameters</b> and <b>Netgen 3D simple
56 parameters</b> allow defining the size of elements for each
57 dimension.
58
59 \b 1D group allows defining the size of 1D elements in either of two ways: 
60 - <b>Number of Segments</b> has the same sense as \ref
61 number_of_segments_anchor "Number of segments" hypothesis with
62 equidistant distribution.
63 - <b>Local Length</b> has the same sense as \ref 
64 average_length_anchor "Local Length" hypothesis.
65
66 \b 2D group allows defining the size of 2D elements 
67 - <b>Length from edges</b> if checked in, acts like \ref
68 length_from_edges_anchor "Length from Edges" hypothesis, else
69 - <b>Max. Element Area</b> defines the maximum element area like \ref
70 max_element_area_anchor "Max Element Area" hypothesis.
71
72 \b 3D groups allows defining the size of 3D elements.
73 - <b>Length from faces</b> if checked in, the area of sides of
74 volumic elements will be equal to an average area of 2D elements, else
75 - <b>Max. Element Volume</b> defines the maximum element volume like
76 \ref max_element_volume_hypo_page "Max Element Volume"
77 hypothesis.
78
79 \note Netgen algorithm does not strictly follow the input
80 parameters. The actual mesh can be more or less dense than
81 required. There are several factors in it:
82 - NETGEN does not actually use "NbOfSegments" parameter for discretization of
83 edge. This parameter is used  only to define the local element size
84 (size at the given point), so local sizes of adjacent edges influence
85 each other.
86 - NETGEN additionally restricts the element size according to edge curvature.
87 - The local size of edges influences the size of close triangles.
88 - The order of elements and their size in the 1D mesh generated by
89 NETGEN differ from those in the 1D mesh generated by Regular_1D
90 algorithm, resulting in different 2D and 3D meshes.
91
92 */