X-Git-Url: http://git.salome-platform.org/gitweb/?p=modules%2Fsmesh.git;a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fconstructing_meshes.doc;fp=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fconstructing_meshes.doc;h=995ee43774abdcd2c90ffa944fbd091afb08a435;hp=0000000000000000000000000000000000000000;hb=79b1ac2b6df9117f16f11d444b1f165d477a1813;hpb=984c4ffdd7df62aeaedc544cd0b8e64ff8f53f1a
diff --git a/doc/salome/gui/SMESH/input/constructing_meshes.doc b/doc/salome/gui/SMESH/input/constructing_meshes.doc
new file mode 100644
index 000000000..995ee4377
--- /dev/null
+++ b/doc/salome/gui/SMESH/input/constructing_meshes.doc
@@ -0,0 +1,112 @@
+/*!
+
+\page constructing_meshes_page Constructing meshes
+
+\n Construction of a mesh consists of:
+
+- Selecting a geometrical object for meshing
+- Applying \ref basic_meshing_algos_page "meshing algorithms" and
+\ref about_hypo_page "hypotheses" which will be used at computation of
+this mesh.
+
+
+To construct a mesh:
+
+- In the \b Mesh menu select Create Mesh or click "Create
+Mesh" button in the toolbar.
+
+\image html image32.gif
+"Create Mesh" button
+
+The following dialog box will appear:
+
+\image html createmesh-inv.png
+
+- For example, you need to mesh a 3d object.
+\n First, type the name for your mesh in the "Name" box, by default,
+it is "Mesh_1". Then select the object you wish to mesh in the Object
+Browser and click the "Add" button.
+
+\image html image120.gif
+"Add" button
+
+Now you can define 1d Algorithm and 1d Hypotheses, which will be
+applied to the edges of your object. (Note that any object has edges,
+even if their existence is not apparent, for example, a sphere has 4
+edges). Click the "Add Hypothesis" button to add a hypothesis.
+
+\image html image121.gif
+"Add Hypothesis" button
+
+Click the "Edit Hypothesis" button to define values for the
+current hypothesis.
+
+\image html image122.gif
+"Edit Hypothesis" button
+
+The use of additional hypotheses is optional (i.e. you may leave
+"None" in this box).
+
+Proceed in the same way with 2d and 3d Algorithms and Hypotheses, note
+that the choice of hypotheses depends on the algorithm. There must be
+one Algorithm and one 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 don't need to define 3d
+Algorithm and Hypotheses.
+\n In the Object Browser the structure of the new mesh will be
+displayed as follows:
+
+\image html image88.jpg
+
+It contains:
+
+- a reference to the geometrical object on the basis of which the mesh has been constructed;
+- Applied hypotheses folder containing the references to the
+hypotheses applied to the construction of the mesh;
+- Applied algorithms folder containing the references to the
+algorithms applied to the construction of the mesh.
+
+
+There is an alternative way to create a mesh on an object simply by
+clicking Assign a set of hypotheses button and selecting between
+Automatic Tetrahedralization or Hexahedralization. The program will
+automatically generate a 3D mesh with the most appropriate
+settings. In the same way you can apply this functionality for meshing
+2D objects, in which case 3D algorithms are not applied.
+- Now, when everything is ready, select your mesh in the Object
+Browser. From the \b Mesh menu select \b Compute or click "Compute" button of the
+toolbar.
+
+\image html image28.gif
+"Compute" button
+
+The Mesh Computation information box appears.
+
+\image html meshcomputationsucceed.png
+
+If the mesh computation failed, the information about the cause of the
+failure is provided.
+
+\image html meshcomputationfail.png
+
+After you select the error, Show Subshape button allows
+visualizing the mesh elements that cause it.
+
+\image html failed_computation.png
+
+Publish Subshape button allows importing it in a separate MED
+or UNV file.
+
+NOTE It is possible to define a 1D or a 2D mesh in a
+python script and then use such submeshes in the construction of a 3D
+mesh. For this, there exist two algorithms: Use existing edges and Use
+existing faces. They are not entirely usable from the GUI, so a
+mesh created using these algorithms should be exported into a python
+script, edited and then imported into the GUi.
+
+Consider trying a sample script for construction of a mesh from our
+\ref tui_creating_meshes_page "TUI Scripts" section.
+
+
+
+*/
\ No newline at end of file