Salome HOME
Avoid empty items in the "Algorithm" combo-box in the "Create/Edit Mesh" dialog.
[modules/smesh.git] / doc / salome / gui / SMESH / input / ghs3d_hypo.doc
index 230929ce7a0cd500824e8bf2cdf20dcfec481849..dfd0041f591b71097e86475d52061ada968e4af8 100644 (file)
@@ -2,9 +2,19 @@
 
 \page ghs3d_hypo_page GHS3D Parameters hypothesis
 
+\anchor ghs3d_top
 \n GHS3D Parameters hypothesis works only with <b>Tetrahedron (GHS3D)</b> 
 algorithm. This algorithm is a commercial software.
+\n To get a licence, visit http://www.distene.com/corp/eval-distene.html
 
+<ol>
+<li>\ref ghs3d_general_parameters "General parameters"</li>
+<li>\ref ghs3d_advanced_parameters "Advanced parameters"</li>
+<li>\ref ghs3d_enforced_vertices "Enforced vertices"</li>
+<li>\ref ghs3d_enforced_meshes "Enforced meshes"</li>
+</ol>
+
+\anchor ghs3d_general_parameters
 <h1>General parameters</h1>
 
 \image html ghs3d_parameters_basic.png
@@ -19,10 +29,22 @@ shape will be meshed. Volumic elements created within holes are bound
 to the solid.</li>
 
 <li><b>Optimization level</b> - allows choosing the required
-optimization level: none, light, medium or strong. Higher level of
+optimization level: 
+<ul>
+<li>none,</li>
+<li>light,</li>
+<li>medium (standard),</li>
+<li>standard+,</li>
+<li>strong.</li>
+</ul>
+Higher level of
 optimisation provides better mesh, but can be time-consuming.
 </li>
+</ul>
+
+\ref ghs3d_top "Back to top"
 
+\anchor ghs3d_advanced_parameters
 <h1>Advanced parameters</h1>
 
 \image html ghs3d_parameters_advanced.png
@@ -56,16 +78,18 @@ together with the characteristics of the final mesh.
 <li><b>To create new nodes</b> - if this option is checked off, ghs3d
 tries to create tetrahedrons using only the nodes of the 2D mesh.</li>
 
-<li><b>To remove initial central point</b> - TetMesh-GHS3D adds an internal point 
-at the centre of gravity of the bounding box in order to speed up and to simplify 
-the meshing process. It is however possible for TetMesh-GHS3D to refrain from creating 
+<li><b>To remove the initial central point</b> TetMesh-GHS3D adds an internal point 
+at the gravity centre of the bounding box to speed up and to simplify 
+the meshing process. However, it is possible to refrain from creating 
 this point by using the command line option -no initial central point. This can be
-particularly useful to generate a volume mesh without internal points at all, and in some rare cases,
-to help the boundary regeneration phase when it failed with the standard options (for example when
-one dimension of the domain is large compared to the other two, with a ratio of 20 or more).
-Use this option when the boundary regeneration failed with the standard parameters and before using
+particularly useful to generate a volume mesh without internal points at all and in some rare cases
+at the boundary regeneration phase when it is impossible to proceed
+with the standard options
+(for example, when one dimension of the domain is more than 20 times greater than the other two).
+Use this option if the boundary regeneration has failed with the standard parameters and before using
 the recovery version (command line option -C).
-Note: when using this option, the speed of the meshing process may decrease, and quality may change.
+Note: when using this option, the speed of the meshing process may
+decrease, and the quality may change.
 Note: the boundary regeneration may fail with this option, in some rare cases.</li>
 
 <li><b>To use boundary recovery version</b> - enables using a
@@ -78,37 +102,85 @@ quality (poor aspect ratio of elements, tetrahedra with a very small
 positive volume).</li>
 
 <li><b>To use FEM correction</b> - Applies finite-element correction by 
-replacing overconstrained elements where it is possible. The process i
-first slicing the overconstrained edges and second the overconstrained 
-facets. This ensures that no edges have two boundary vertices and that 
-no facets have three boundary vertices. TetMesh-GHS3D gives the initial 
+replacing overconstrained elements where it is possible. At first the proces
+slices the overconstrained edges and at second the overconstrained 
+facets. This ensures that there are no edges with two boundary
+vertices and that there are no facets with three boundary vertices. TetMesh-GHS3D gives the initial 
 and final overconstrained edges and facets. It also gives the facets
 which have three edges on the boundary.
 Note: when using this option, the speed of the meshing process may 
 decrease, quality may change, and the smallest volume may be smaller.
-The default is no correction.</li>
+By default, the FEM correction is not used.</li>
 
-<li><b>Option as text</b> - allows input of any text as command line
-for ghs3d. This allows the input of advanced options in a free from. </li>
+<li><b>Option as text</b> - allows to input in the command line any text
+for ghs3d, for example, advanced options. </li>
 
 </ul>
 
+\ref ghs3d_top "Back to top"
 
+\anchor ghs3d_enforced_vertices
 <h1>Enforced vertices</h1>
 
-\image html ghs3d_enforced_vertices.png
+\note This feature is currently available only on meshes with no
+geometry attached. Such meshes can be obtained by
+<ul>
+<li>Copying an existing mesh</li>
+<li>Importing a mesh from file</li>
+<li>Applying a transformation to a mesh a get result in a new mesh</li>
+</ul>
 
-GHS3D algorithm can locally raffine the mesh. It is possible to define enforced vertices in the volume where the mesh will be raffined.
+\image html ghs3d_enforced_vertices.png
 
-A node will be created at the enforced vertex coordinates. There is no need to create a vertex in the CAD.
+GHS3D algorithm can locally make the mesh finer. It is possible to
+define enforced vertices in the volume where the mesh will be detailed.
+A node will be created at the enforced vertex coordinates.
 
 An enforced vertex is defined by:
 <ul>
-<li>The (x,y,z) cartesian coordinates</li>
+<li>A vertex</li>
+<ul>
+<li>from GEOM (Vertex, Compound)</li>
+<li>or from (x,y,z) cartesian coordinates</li>
+</ul>
 <li>A constant physical size</li>
+<li>If a group name is given, the created node will be added to the
+group. If the group does not exist, it is created.</li>
+</ul>
+\ref ghs3d_top "Back to top"
+
+\anchor ghs3d_enforced_meshes
+<h1>Enforced Meshes</h1>
+
+\note This feature is currently only available on meshes with no
+geometry attached. Such meshes can be obtained by
+<ul>
+<li>Copying an existing mesh</li>
+<li>Importing a mesh from file</li>
+<li>Applying a transformation to a mesh a get result in a new mesh</li>
+</ul>
+
+\image html ghs3d_enforced_meshes.png
+
+GHS3D algorithm can be forced by other meshes, sub-meshes or
+groups. The constraint elements should be contained
+entirely into the solid mesh.
+<ul>
+<li>The constraint element types are:
+<ul>
+<li>NODE</li>
+<li>EDGE</li>
+<li>FACE</li>
+</ul></li>
+<li>If a size is given, the mesh will be refined around the enforced
+elements given the size</li>
+<li>If a group name is given, the enforced elements will be added to
+the group. If the group does not exist, it is created.</li>
 </ul>
 
 <br><b>See Also</b> a sample TUI Script of the \ref tui_ghs3d "creation of a Ghs3D hypothesis", including enforced vertices.
 
+\ref ghs3d_top "Back to top"
+
 
-*/
\ No newline at end of file
+*/