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