X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fconstructing_meshes.doc;h=ace081140d0913d0dcb45322ab0bf4beb92845fe;hb=8a5f517e60c56d7ddbd35cfae74d69bac8edd36d;hp=995ee43774abdcd2c90ffa944fbd091afb08a435;hpb=79b1ac2b6df9117f16f11d444b1f165d477a1813;p=modules%2Fsmesh.git diff --git a/doc/salome/gui/SMESH/input/constructing_meshes.doc b/doc/salome/gui/SMESH/input/constructing_meshes.doc index 995ee4377..ace081140 100644 --- a/doc/salome/gui/SMESH/input/constructing_meshes.doc +++ b/doc/salome/gui/SMESH/input/constructing_meshes.doc @@ -5,8 +5,8 @@ \n Construction of a mesh consists of: @@ -15,7 +15,7 @@ this mesh.
  • In the \b Mesh menu select Create Mesh or click "Create Mesh" button in the toolbar. -\image html image32.gif +\image html image32.png
    "Create Mesh" button
    The following dialog box will appear: @@ -27,7 +27,7 @@ The following dialog box will appear: 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 +\image html image120.png
    "Add" button
    Now you can define 1d Algorithm and 1d Hypotheses, which will be @@ -35,13 +35,13 @@ 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 +\image html image121.png
    "Add Hypothesis" button
    Click the "Edit Hypothesis" button to define values for the current hypothesis. -\image html image122.gif +\image html image122.png
    "Edit Hypothesis" button
    The use of additional hypotheses is optional (i.e. you may leave @@ -73,11 +73,43 @@ 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 + +\anchor preview_mesh_anchor + +
  • After the mesh object is created and all hypotheses are assigned and +before the mesh computation, it is possible to see the mesh preview. + +For this, select the mesh in the Object Browser. From the \b Mesh menu +select \b Preview or click "Preview" button in the +toolbar or activate "Preview" item from the pop-up menu. + +\image html mesh_precompute.png +
    "Preview" button
    + +Select 1D mesh or 2D mesh preview mode in the Preview dialog. + + +\image html preview_mesh_1D.png "1D mesh preview shows nodes computed on geometry edges" + +\image html preview_mesh_2D.png "2D mesh preview shows edge mesh elements, computed on geometry faces" + +Compute button computes the whole mesh. + +When the Preview dialog is closed, the question about the storage of temporarily +created mesh elements appers: + +\image html preview_tmp_data.png + +These elenents can be reused in the next mesh computation. +
    • + + +
  • It is equally possible to skip the Preview and \b Compute the mesh +after the hypotheses are assigned. For this, 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 +\image html image28.png
    "Compute" button
    The Mesh Computation information box appears. @@ -90,12 +122,21 @@ failure is provided. \image html meshcomputationfail.png After you select the error, Show Subshape button allows -visualizing the mesh elements that cause it. +visualizing the geometrical entity that causes it. -\image html failed_computation.png +\image html failed_computation.png "Example of the invalid input mesh" -Publish Subshape button allows importing it in a separate MED -or UNV file. +\note Mesh Computation Information box does not appear if you set +"Mesh computation/Show a computation result notification" preference +to the "Never" value. This option gives the possibility to control mesh +computation reporting. There are the following possibilities: always +show information box, only if an error occurs or never. +By default, the information box is always shown after mesh computation operation. + +Publish Subshape button publishes the subshape, whose meshing +failed, in GEOM component as a child of the mesh geometry, which +allows analyzing the problem geometry and creating a submesh on it in +order to locally tune hypotheses. 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 @@ -104,9 +145,97 @@ 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. +
  • It is possible to calculate the eventual mesh size +before \b Compute operation. For this, select the mesh in the Object +Browser 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 +
    • + + +\anchor mesh_order_anchor + +
  • +If the mesh contains concurrent submeshes, it is possible to change +the priority of their computation, i.e. to change the priority of +applying algorithms to the shared subshapes of the Mesh shape.
    • + +To change submesh priority: + +
  • Choose "Change submesh priority" from the Mesh menu or a popup menu. The opened dialogue +shows a list of submeshes in the order of their priority. + +There is an example of submesh order modifications of the Mesh created on a Box +shape. The main Mesh object: + +The first submesh object Submesh_1 created on Face_1 +is: + +The second submesh object Submesh_2 created on Face_2 +is: + + +And the last submesh object Submesh_3 created on Face_3 +is: + +The submeshes become concurrent if they share subshapes that can be meshed +with different algorithms (or different hypothesises). +In the example, we have three submeshes with concurrent algorithms, +because they have different hypotheses. + +The first mesh computation is made with: +\image html mesh_order_123.png +
    "Mesh order SubMesh_1, SubMesh_2, SubMesh_3"
    +\image html mesh_order_123_res.png +
    "Result mesh with order SubMesh_1, SubMesh_2, SubMesh_3 "
    + +The next mesh computation is made with: +\image html mesh_order_213.png +
    "Mesh order SubMesh_2, SubMesh_1, SubMesh_3"
    +\image html mesh_order_213_res.png +
    "Result mesh with order SubMesh_2, SubMesh_1, SubMesh_3 "
    + +And the last mesh computation is made with: +\image html mesh_order_321.png +
    "Mesh order SubMesh_3, SubMesh_2, SubMesh_1"
    +\image html mesh_order_321_res.png +
    "Result mesh with order SubMesh_3, SubMesh_2, SubMesh_1 "
    + +As we can see, each mesh computation has a different number of result +elements and a different mesh discretisation on the shared edges (the edges +that are shared between Face_1, Face_2 and Face_3) + +Additionally, submesh priority (the order of applied algorithms) can +be modified not only in a separate dialog box, but also in the +Preview. This helps to preview different mesh results, +modifying the order of submeshes. +\image html mesh_order_preview.png +
    "Preview with submesh priority list box"
    + +If there are no concurrent submeshes under the Mesh object, the user will see the +following information. +\image html mesh_order_no_concurrent.png +
    "No concurrent submeshes detected"
    + -*/ \ No newline at end of file +Consider trying a sample script for construction of a mesh from our +\ref tui_creating_meshes_page "TUI Scripts" section. + +*/