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

diff --git a/doc/salome/gui/SMESH/input/ghs3d_hypo.doc b/doc/salome/gui/SMESH/input/ghs3d_hypo.doc
index 230929ce7a0cd500824e8bf2cdf20dcfec481849..dfd0041f591b71097e86475d52061ada968e4af8 100644 (file)
--- a/doc/salome/gui/SMESH/input/ghs3d_hypo.doc
+++ b/doc/salome/gui/SMESH/input/ghs3d_hypo.doc
@@ -2,9 +2,19 @@
 
 \page ghs3d_hypo_page GHS3D Parameters hypothesis
 
 
 \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 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
 <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
 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>
 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
 <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 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
 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).
 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
 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 
 positive volume).</li>
 
 <li><b>To use FEM correction</b> - Applies finite-element correction by 

-replacing overconstrained elements where it is possible. The process is 
-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 process 
+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.
 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>
 
 
 </ul>
 

+\ref ghs3d_top "Back to top"

 
 

+\anchor ghs3d_enforced_vertices

 <h1>Enforced vertices</h1>
 
 <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>
 
 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>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.
 
 </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
+*/