+ <li>Select a geometrical object for meshing.</li>
+ <li>In the \b Mesh menu select <b>Create Mesh</b> or click <em>"Create
+ Mesh"</em> button in the toolbar.
+
+ <center>
+ \image html image32.png
+ <em>"Create Mesh" button</em>
+ </center>
+
+ The following dialog box will appear:
+
+ \image html createmesh-inv.png
+ <br>
+ </li>
+ <li> To filter off irrelevant meshing algorithms, you can
+ select <b>Mesh Type</b> in the corresponding list from <b>Any,
+ Hexahedral, Tetrahedral, Triangular </b> and \b Quadrilateral (there
+ can be less items for the geometry of lower dimensions).
+
+ Selection of a mesh type hides all meshing algorithms that cannot
+ generate elements of this type.</li>
+
+ <li>Apply \subpage basic_meshing_algos_page "meshing algorithms" and
+ \subpage about_hypo_page "hypotheses" which will be used to compute
+ this mesh.
+
+ "Create mesh" dialog box contains several tab pages titled \b 3D,
+ \b 2D, \b 1D and \b 0D. The title of each page reflects the
+ dimension of the sub-shapes the algorithms listed on
+ this page affect and the maximal dimension of elements the algorithms
+ generate. For example, \b 3D page lists the algorithms that affect
+ 3D sub-shapes (solids) and generate 3D mesh elements
+ (tetrahedra, hexahedra etc.)
+
+ As soon as you have selected an algorithm, you can create a
+ hypothesis (or select an already created one). A set of accessible
+ hypotheses includes only the hypotheses that can be used by the
+ selected algorithm.
+
+ \note
+ - Some page(s) can be disabled if the geometrical
+ object does not include shapes (sub-shapes) of the corresponding
+ dimension(s). For example, if the input object is a geometrical face,
+ \b 3D page is disabled.
+ - Some algorithms affect the geometry of several dimensions,
+ i.e. 1D+2D or 1D+2D+3D. If such an algorithm is selected, the
+ dialog pages related to the corresponding lower dimensions are
+ disabled.
+ - \b 0D page refers to 0D geometry (vertices) rather than
+ to 0D elements. Mesh module does not provide algorithms that
+ produce 0D elements. Currently \b 0D page provides only one
+ algorithm "Segments around vertex" that allows specifying the required
+ size of mesh edges about the selected vertex (or vertices).
+
+ For example, you need to mesh a 3D object.
+
+ First, you can change a default name of your mesh in the \b Name
+ box. Then check that the selected geometrical object indicated in
+ \b Geometry field, is what you wish to mesh; if not, select
+ the correct object in the Object Browser. Click "Select" button
+ near \b Geometry field if the name of the object has not yet
+ appeared in \b Geometry field.
+ <center>
+ \image html image120.png
+ <em>"Select" button</em>
+ </center>
+
+ Now you can define 3D Algorithm and 3D Hypotheses, which will be
+ applied to discretize the solids of your geometrical object using
+ 3D elements. Click the <em>"Add Hypothesis"</em> button to create
+ and add a hypothesis.
+ <center>
+ \image html image121.png
+ <em>"Add Hypothesis" button</em>
+ </center>
+ Click the <em>"Plus"</em> button to enable adding more additional hypotheses.
+
+ Click the <em>"Edit Hypothesis"</em> button to change the values for the
+ current hypothesis.
+ <center>
+ \image html image122.png
+ <em>"Edit Hypothesis" button</em>
+ </center>
+
+ Most 2D and 3D algorithms can work without hypotheses using
+ default meshing parameters. Some algorithms do not require any
+ hypotheses. After selection of an algorithm "Hypothesis" field of
+ the dialog can contain:
+ <ul>
+ <li> <em>\<Default\></em> if the algorithm can work using default
+ parameters.</li>
+ <li> <em>\<None\></em> if the algorithm requires a hypothesis defining
+ its parameters.</li>
+ <li> If the algorithm does not use hypotheses, this field is grayed.</li>
+ </ul>
+ After selection of an algorithm <b>Add. Hypothesis</b> field can contain:
+ <ul>
+ <li> <em>\<None\></em> if the algorithm can be tuned
+ using an additional hypothesis.</li>
+ <li> If the algorithm does not use additional hypotheses, this field is grayed.</li>
+ </ul>
+
+ Proceed in the same way with 2D and 1D Algorithms and Hypotheses that
+ will be used to mesh faces and edges of your geometry. (Note
+ that any object has edges, even if their existence is not
+ apparent, for example, a sphere has 4 edges). Note that the
+ choice of hypotheses and lower dimension algorithms depends on
+ the higher dimension algorithm.
+
+ If you wish you can select other algorithms and/or hypotheses
+ for meshing some sub-shapes of your CAD model by \ref constructing_submeshes_page.
+
+ Some algorithms generate mesh of several dimensions, while others
+ produce mesh of only one dimension. In the latter case there must
+ be one Algorithm and zero or several
+ Hypotheses for each dimension of your object, otherwise you will
+ not get any mesh at all. Of course, if you wish to mesh a face,
+ which is a 2D object, you do not need to define a 3D Algorithm and
+ Hypotheses.
+
+ In the <b>Object Browser</b> the structure of the new mesh is
+ displayed as follows:
+ \image html image88.jpg
+ It contains:
+ <ul>
+ <li>a mesh name (<em>Mesh_mechanic</em>);
+ <li>a reference to the geometrical object on the basis of
+ which the mesh has been constructed (\a mechanic);</li>
+ <li><b>Applied hypotheses</b> folder containing the references
+ to the hypotheses chosen at the construction of the mesh;</li>
+ <li><b>Applied algorithms</b> folder containing the references
+ to the algorithms chosen at the construction of the mesh.</li>
+ <li><b>SubMeshes on Face</b> folder containing the sub-meshes
+ defined on geometrical faces. There also can be folders for
+ sub-meshes on vertices, edges, wires, shells, solids and
+ compounds.</li>
+ <li><b>Groups of Faces</b> folder containing the groups of mesh
+ faces. There also can be folders for groups of nodes, edges,
+ volumes 0D elements and balls.</li>
+ </ul>
+
+ There is an alternative way to assign Algorithms and Hypotheses by
+ clicking <b>Assign a set of hypotheses</b> button and selecting among
+ pre-defined sets of algorithms and hypotheses. In addition to the built-in
+ sets of hypotheses, it is possible to create custom sets by editing
+ CustomMeshers.xml file located in the home directory. CustomMeshers.xml
+ file must describe sets of hypotheses in the
+ same way as ${SMESH_ROOT_DIR}/share/salome/resources/smesh/StdMeshers.xml
+ file does (sets of hypotheses are enclosed between \<hypotheses-set-group\>
+ tags). For example:
+~~~~~~{.xml}
+ <?xml version='1.0' encoding='us-ascii'?>
+ <!DOCTYPE meshers PUBLIC "" "desktop.dtd">
+ <meshers>
+ <hypotheses-set-group>
+ <hypotheses-set name="My favorite hypotheses"
+ hypos="AutomaticLength"
+ algos="CompositeSegment_1D, Quadrangle_2D, GHS3D_3D"/>
+ </hypotheses-set-group>
+ </meshers>
+~~~~~~
+ If the file contents are incorrect, there can be an error at
+ activation of Mesh module: <em>"fatal parsing error: error
+ triggered by consumer in line ..."</em>
+<br>
+<center>
+ \image html hypo_sets.png
+ List of sets of hypotheses. Tag <em>[custom]</em> is
+ automatically added to the sets defined by the user.
+</center>
+ \note
+ - \a "Automatic" in the names of predefined sets of hypotheses
+ does not actually mean that they are suitable for meshing any
+ geometry.
+ - The list of sets of hypotheses can be shorter than in the
+ above image depending on the geometry dimension.
+ </li>
+</ol>
+
+Consider trying a sample script for construction of a mesh from our
+\ref tui_creating_meshes_page "TUI Scripts" section.
+
+\anchor evaluate_anchor
+<h2>Evaluating mesh size</h2>
+
+After the mesh object is created and all hypotheses are assigned and
+before \ref compute_anchor "Compute" operation, it is possible to
+calculate the eventual mesh size. For this, select the mesh in
+the <b>Object Browser</b> and from the \b Mesh menu select \b
+Evaluate. The result of evaluation will be displayed in the following
+information box:
+
+\image html mesh_evaluation_succeed.png