\image html a-arithmetic1d.png
-\image html b-ithmetic1d.png
+\image html b-ithmetic1d.png "Arithmetic 1D hypothesis - the size of mesh elements gradually increases"
<b>See Also</b> a sample TUI Script of a
\ref tui_1d_arithmetic "Defining Arithmetic 1D hypothesis" operation.
\image html a-deflection1d.png
-\image html b-flection1d.png
+\image html b-flection1d.png "Deflection 1D hypothesis - useful for meshing curvilinear edges"
<b>See Also</b> a sample TUI Script of a
\ref tui_deflection_1d "Defining Deflection 1D hypothesis" operation.
\image html a-averagelength.png
-\image html b-erage_length.png
+\image html b-erage_length.png "Average length hypothesis - all 1D mesh elements are roughly equal"
<b>See Also</b> a sample TUI Script of a
\ref tui_average_length "Defining Average Length" hypothesis
<br><b>Equidistant Distribution</b> - all segments will have the same
length, you define only the <b>Number of Segments</b>.
-\image html b-mberofsegments.png
-
<br><b>Scale Distribution</b> - length of segments gradually changes depending on the <b>Scale Factor</b>, which is a ratio of the first segment length to the last segment length.
\image html a-nbsegments2.png
<b>Start and End Length</b> hypothesis allows to divide a geometrical edge
into segments so that the first and the last segments have a specified
-length. The length of each but the first segment differs from length
-of the previous one by a constant factor. Then mesh nodes are
+length. The length medium segments changes with automatically chosen
+geometric progression. Then mesh nodes are
constructed at segment ends location and 1D mesh elements are
constructed on them.
\image html a-startendlength.png
-\image html b-art_end_length.png
+\image html b-art_end_length.png "The lengths of the first and the last segment are strictly defined"
<b>See Also</b> a sample TUI Script of a
\ref tui_start_and_end_length "Defining Start and End Length"
elements). Compare one and the same object (sphere) meshed with
minimum and maximum value of this parameter.
-\image html image147.gif
-
-\image html image148.gif
+\image html image147.gif "Example of a very rough mesh. Automatic Length works for 0."
+\image html image148.gif "Example of a very fine mesh. Automatic Length works for 1."
*/
\image html a-maxelarea.png
-\image html max_el_area.png
+\image html max_el_area.png "In this example, Max. element area is very small compared to the 1D hypothesis"
<b>See Also</b> a sample TUI Script of a
\ref tui_max_element_area "Maximum Element Area" hypothesis
In \b MESH there are the following Basic Hypotheses (to introduce
them, you operate numerical values):
<ul>
-<li>\ref a1d_meshing_hypo_page "1D Hypotheses" (for meshing of
+<li>\subpage a1d_meshing_hypo_page "1D Hypotheses" (for meshing of
<b>edges</b>):</li>
<ul>
<li>\ref arithmetic_1d_anchor "Arithmetic 1D"</li>
<li>\ref start_and_end_length_anchor "Start and end length"</li>
<li>\ref automatic_length_anchor "Automatic Length"</li>
</ul>
-<li>\ref a2d_meshing_hypo_page "2D Hypotheses" (for meshing of <b>faces</b>):</li>
+<li>\subpage a2d_meshing_hypo_page "2D Hypotheses" (for meshing of <b>faces</b>):</li>
<ul>
<li>\ref max_element_area_anchor "Max Element Area"</li>
<li>\ref length_from_edges_anchor "Length from Edges"</li>
</ul>
<li>3D Hypothesis (for meshing of <b>volumes</b>):</li>
<ul>
-<li>\ref max_element_volume_hypo_page "Max Element Volume"</li>
+<li>\subpage max_element_volume_hypo_page "Max Element Volume"</li>
</ul>
</ul>
-There also exist some
-\ref additional_hypo_page "Additional Hypotheses":
+Some hypotheses are strictly combined with plug-in
+meshers and thus, work only with definite algorithms.
+<ul>
+<li>\subpage netgen_2d_3d_hypo_page</li> - work with NetGen algorithm.
+<li>\subpage ghs3d_hypo_page</li> - works with GHS3D algorithm.
+<li>\subpage blsurf_hypo_page</li> - works with BLSURF algorithm.
+</ul>
+
+There also exist
+\subpage additional_hypo_page "Additional Hypotheses" used together
+with other hypotheses:
<ul>
<li>Propagation of 1D Hypothesis on opposite edges</li>
<li>Non conform mesh allowed</li>
<li>the geometrical object (shape) which will be meshed</li>
<li>the algorithm, which will be selected for meshing of this geometrical object (shape)</li>
</ul>
+
*/
\ No newline at end of file
\page about_meshes_page About meshes
\n \b MESH represents a discretization of a geometrical CAD model into
-a set of entities with a simple topology. In MESH there are two
-options of creation of meshes, you can:
+a set of entities with a simple topology.
-<ul>
-<li>generate meshes on the basis of geometrical shapes produced in the GEOM module,</li>
-<li>create your own meshes using the MESH functions destined for modification of generated meshes.</li>
-</ul>
+Meshes are stored in DAT, MED and UNV formats and can be
+\subpage importing_exporting_meshes_page "imported from and exported to"
+ the file in these formats.
+
+However, it is possible to \subpage constructing_meshes_page "construct meshes"
+on the basis of geometrical shapes produced in the GEOM module.
+It is also possible to \subpage constructing_submeshes_page "create mesh on a part of the geometrical object",
+for example, a face.
+
+Several created meshes can be \subpage building_compounds_page "combined into mesh compounds".
+
+All created meshes and submeshes can be \subpage editing_meshes_page "edited".
+
+Meshes can be also using the MESH functions destined for
+\ref modifying_meshes_page "modification" of generated meshes.
-The topology of a mesh is described by the relationships between its
+The \b topology of a mesh is described by the relationships between its
entities including:
<ul>
/*!
-\page about_quality_controls_page About quality controls
+\page quality_page About quality controls
\n <b>Mesh quality control</b> in MESH is destined for visual control of the generated mesh.
1D mesh quality controls:
<ul>
-<li>\ref free_borders_page "Free borders"</li>
-<li>\ref borders_at_multi_connection_page "Borders at multi-connection"</li>
-<li>\ref length_page "Length"</li>
+<li>\subpage free_borders_page "Free borders"</li>
+<li>\subpage borders_at_multi_connection_page "Borders at multi-connection"</li>
+<li>\subpage length_page "Length"</li>
</ul>
2D mesh quality controls:
<ul>
-<li>\ref free_edges_page "Free edges"</li>
-<li>\ref length_2d_page "Length 2D"</li>
-<li>\ref borders_at_multi_connection_2d_page "Borders at multi-connection 2D"</li>
-<li>\ref area_page "Area"</li>
-<li>\ref taper_page "Taper"</li>
-<li>\ref aspect_ratio_page "Aspect ratio"</li>
-<li>\ref minimum_angle_page "Minimum angle"</li>
-<li>\ref warping_page "Warping"</li>
-<li>\ref skew_page "Skew"</li>
+<li>\subpage free_edges_page "Free edges"</li>
+<li>\subpage length_2d_page "Length 2D"</li>
+<li>\subpage borders_at_multi_connection_2d_page "Borders at multi-connection 2D"</li>
+<li>\subpage area_page "Area"</li>
+<li>\subpage taper_page "Taper"</li>
+<li>\subpage aspect_ratio_page "Aspect ratio"</li>
+<li>\subpage minimum_angle_page "Minimum angle"</li>
+<li>\subpage warping_page "Warping"</li>
+<li>\subpage skew_page "Skew"</li>
</ul>
3D mesh quality controls:
<ul>
-<li>\ref aspect_ratio_3d_page "Aspect ratio 3D"</li>
-<li>\ref volume_page "Volume"</li>
+<li>\subpage aspect_ratio_3d_page "Aspect ratio 3D"</li>
+<li>\subpage volume_page "Volume"</li>
</ul>
*/
\ No newline at end of file
<li>From the \b Modification menu choose the \b Add item, the
following associated submenu will appear:</li>
-\image html image146.gif
+\image html image146.png
From this submenu select the type of element which you would like to add to your mesh.
</ol>
<li>From the \b Modification menu choose the \b Add item and select
one of the following:
-\image html image152.gif
+\image html image152.png
To create any <b>Quadratic Element</b> specify the nodes which will form your
triangle by selecting them in the 3D viewer with pressed Shift
<li>Choose <b>Controls > Area</b> or click <em>"Area"</em> button.
-\image html image35.gif
+\image html image35.png
<center><em>"Area" button</em></center>
Your mesh will be displayed in the viewer with its elements colored
<li>Choose <b>Controls > Aspect Ratio</b> or click <em>"Aspect
Ratio"</em> button in the toolbar.
-\image html image37.gif
+\image html image37.png
<center><em>"Aspect Ratio" button</em></center>
Your mesh will be displayed in the viewer with its elements colored
<li>Choose <b>Controls > Aspect Ratio 3D</b> or click <em>"Aspect Ratio 3D"</em>
button of the toolbar.
-\image html image144.gif
+\image html image144.png
<center><em>"Aspect Ratio 3D" button</em></center>
Your mesh will be displayed in the viewer with its elements colored
quadrangular elements.</li>
</ul>
-\image html image123.gif
+\image html image123.gif "Example of a triangular 2D mesh"
-\image html image124.gif
+\image html image124.gif "Example of a quadrangular 2D mesh"
<li>For meshing of 3D entities (<b>volume objects</b>):</li>
tetrahedral (pyramidal) elements.</li>
</ul>
-\image html image125.gif
+\image html image125.gif "Example of a tetrahedral 3D mesh"
-\image html image126.gif
+\image html image126.gif "Example of a hexahedral 3D mesh"
</ul>
-Note that BLSURF and GHS3D are commercial meshers.\n
+\Note that BLSURF and GHS3D are commercial meshers and require a
+license to be used within the Mesh module.
-There also is a number of more specific algorithms:
+There is also a number of more specific algorithms:
<ul>
-<li>\ref projection_algos_page "for meshing by projection of another mesh"</li>
-<li>\ref radial_prism_algo_page "for meshing geometrical objects with cavities"</li>
-<li>\ref prism_3d_algo_page "for meshing prismatic shapes"</li>
+<li>\subpage projection_algos_page "for meshing by projection of another mesh"</li>
+<li>\subpage radial_prism_algo_page "for meshing geometrical objects with cavities"</li>
+<li>\subpage segments_around_vertex_algo_page "for defining the local size of elements around a certain node"</li>
+<li>\subpage prism_3d_algo_page "for meshing prismatic shapes"</li>
</ul>
\ref constructing_meshes_page "Constructing meshes" page describes in
From the \b Mesh menu select <b>Build Compound</b> or click <em>"Build
Compound Mesh"</em> button in the toolbar.
-\image html image161.gif
+\image html image161.png
<center><em>"Build Compound Mesh" button</em></center>
\par
for this operation.</li>
</ul>
-\n <b>Example:</b>
-
-\image html image160.gif
+\image html image160.gif "Example of a compound of two meshed cubes"
*/
<li>In the \b Modification menu select the \b Orientation item or click
<em>Orientation</em> button in the toolbar.
-\image html image79.gif
+\image html image79.png
<center><em>"Orientation" button</em></center>
The following dialog box will appear:
Z). If the <b>Show preview</b> button is on, you can see the clipping plane
in the <b>3D Viewer</b>.
-\image html image79.jpg
+\image html image79.jpg "The plane and the cut object"
If the <b>Auto Apply</b> button is on, you can preview the
cross-section in the <b>3D Viewer</b>.
-\image html image99.gif
+\image html image99.gif "The cross-section"
To get a new object from \b Clipping, click \b Apply.
+++ /dev/null
-/*!
-
-\page constructing_groups_of_specific_elements_page Constructing groups of specific elements
-
-\n In MESH you can easily construct groups of specific elements (nodes,
-edges, faces or volumes) which will be taken from a definite submesh.
-
-<em>To construct a group of specific elements:</em>
-
-\par
-Right-click on a submesh in the Object Browser and choose the
-<b>Construct Group</b> item or select your submesh in the Object Browser and
-in the \b Mesh menu choose the <b>Construct Group</b> item. MESH will construct
-several groups consisting of elements of the definite type: nodes,
-edges, faces or volumes.
-
-*/
\ No newline at end of file
\n Construction of a mesh consists of:
<ul>
<li>Selecting a geometrical object for meshing</li>
-<li>Applying \ref basic_meshing_algos_page "meshing algorithms" and
-\ref about_hypo_page "hypotheses" which will be used at computation of
+<li>Applying \subpage basic_meshing_algos_page "meshing algorithms" and
+\subpage about_hypo_page "hypotheses" which will be used at computation of
this mesh.</li>
</ul>
<li>In the \b Mesh menu select <b>Create Mesh</b> or click <em>"Create
Mesh"</em> button in the toolbar.
-\image html image32.gif
+\image html image32.png
<center><em>"Create Mesh" button</em></center>
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
<center><em>"Add" button</em></center>
Now you can define 1d Algorithm and 1d Hypotheses, which will be
even if their existence is not apparent, for example, a sphere has 4
edges). Click the <em>"Add Hypothesis"</em> button to add a hypothesis.
-\image html image121.gif
+\image html image121.png
<center><em>"Add Hypothesis" button</em></center>
Click the <em>"Edit Hypothesis"</em> button to define values for the
current hypothesis.
-\image html image122.gif
+\image html image122.png
<center><em>"Edit Hypothesis" button</em></center>
The use of additional hypotheses is optional (i.e. you may leave
Browser</b>. From the \b Mesh menu select \b Compute or click "Compute" button of the
toolbar.
-\image html image28.gif
+\image html image28.png
<center><em>"Compute" button</em></center>
The Mesh Computation information box appears.
After you select the error, <b>Show Subshape</b> button allows
visualizing the geometrical entity that causes it.
-\image html failed_computation.png
+\image html failed_computation.png "Example of the invalid input mesh"
+
+\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.
<b>Publish Subshape</b> button publishes the subshape, whose meshing
failed, in GEOM component as a child of the mesh geometry, which
<br><em>To construct a submesh:</em>
\par
-From the \b Mesh menu select <b>Local Hyp.</b> or click <em>"Create
+From the \b Mesh menu select <b>Create Submesh</b> or click <em>"Create
Sum-mesh"</em> button in the toolbar.
\image html image33.gif
-<center><em>"Create Sum-mesh" button</em></center>
+<center><em>"Create Submesh" button</em></center>
\par
The following dialog box will appear:
Mesh item, or click <em>"Convert to/from quadratic"</em> button in the
toolbar.
-\image html image154.gif
+\image html image154.png
<center><em>"Convert to/from quadratic" button</em></center>
The following dialog box will appear:
+++ /dev/null
-/*!
-
-\page creating_meshes_page Creating meshes
-
-<ul>
-<li>\subpage about_meshes_page</li>
-<li>\subpage importing_exporting_meshes_page</li>
-<li>\subpage constructing_meshes_page</li>
-<li>\subpage defining_algos_page</li>
-<ul>
-<li>\ref basic_meshing_algos_page</li>
-<li>\ref projection_algos_page</li>
-<li>\ref radial_prism_algo_page</li>
-<li>\ref segments_around_vertex_algo_page</li>
-<li>\ref prism_3d_algo_page</li>
-</ul>
-<li>\subpage defining_hypo_page</li>
-<ul>
-<li>\ref about_hypo_page</li>
-<li>\ref a1d_meshing_hypo_page</li>
-<li>\ref a2d_meshing_hypo_page</li>
-<li>\ref max_element_volume_hypo_page</li>
-<li>\ref netgen_2d_3d_hypo_page</li>
-<li>\ref ghs3d_hypo_page</li>
-<li>\ref blsurf_hypo_page</li>
-<li>\ref additional_hypo_page</li>
-</ul>
-<li>\subpage constructing_submeshes_page</li>
-<li>\subpage building_compounds_page</li>
-<li>\subpage editing_meshes_page</li>
-</ul>
-
-*/
\ No newline at end of file
<li>In the \b Modification menu select the <b>Cutting of quadrangles</b> item or
click <em>"Cutting of quadrangles"</em> button in the toolbar.
-\image html image82.gif
+\image html image82.png
<center><em>"Cutting of quadrangles" button</em></center>
The following dialog box will appear:
<li>Click the \b Apply or <b>Apply and Close</b> button to confirm the operation.</li>
</ol>
-\image html image52.jpg
+\image html image52.jpg "The chosen quadrangular element"
-\image html image51.jpg
+\image html image51.jpg "Two resulting triangular elements"
<br><b>See Also</b> a sample TUI Script of a
\ref tui_cutting_quadrangles "Cutting Quadrangles" operation.
+++ /dev/null
-/*!
-
-\page defining_algos_page Defining Algorithms
-
-<ul>
-<li>\subpage basic_meshing_algos_page</li>
-<li>\subpage projection_algos_page</li>
-<li>\subpage radial_prism_algo_page</li>
-<li>\subpage segments_around_vertex_algo_page</li>
-<li>\subpage prism_3d_algo_page</li>
-</ul>
-
-*/
\ No newline at end of file
+++ /dev/null
-/*!
-
-\page defining_hypo_page Defining hypotheses
-
-<ul>
-<li>\subpage about_hypo_page</li>
-<li>\subpage a1d_meshing_hypo_page</li>
-<li>\subpage a2d_meshing_hypo_page</li>
-<li>\subpage max_element_volume_hypo_page</li>
-<li>\subpage netgen_2d_3d_hypo_page</li>
-<li>\subpage ghs3d_hypo_page</li>
-<li>\subpage blsurf_hypo_page</li>
-<li>\subpage additional_hypo_page</li>
-</ul>
-
-*/
\ No newline at end of file
<li>From the \b Modification menu choose the <b>Diagonal inversion</b> item or
click <em>"Diagonal Inversion"</em> button in the toolbar.
-\image html image70.gif
+\image html image70.png
<center><em>"Diagonal Inversion" button</em></center>
The following dialog box shall appear:
<li>Click the \b Apply or <b>Apply and Close</b> button.</li>
</ol>
-\image html image38.jpg
+\image html image38.jpg "The selected edge"
-\image html image36.jpg
+\image html image36.jpg "The inverted edge"
<br><b>See Also</b> a sample TUI Script of a
\ref tui_diagonal_inversion "Diagonal Inversion of Elements" operation.
\b Shading and \b Wireframe modes can combine with \b Shrink, however
\b Nodes can't.
-\image html image55.gif
+\image html image55.gif Shrink
*/
\ No newline at end of file
You can also change values for the current hypothesis by clicking the
<em>"Edit Hypothesis"</em> button.
-\image html image122.gif
+\image html image122.png
<center><em>"Edit Hypothesis" button</em></center>
-See how a mesh constructed on one and the same geometrical object
+See how the mesh constructed on a geometrical object
changes if we apply different algorithms to it.
-\image html edit_mesh1.png
+\image html edit_mesh1.png "Example of a mesh with Max. Element area 2D hypothesis roughly corresponding to 1D hypotheses on edges"
-\image html edit_mesh_remove_hyp.png
-
-\image html edit_mesh_change_value_hyp.png
+\image html edit_mesh_change_value_hyp.png "And now the Max Element area is greatly reduced"
<br><b>See Also</b> a sample TUI Script of an
\ref tui_editing_mesh "Edit Mesh" operation.
<li>From the \b Modification menu choose the \b Extrusion item or click
<em>"Extrusion"</em> button in the toolbar.
-\image html image91.gif
+\image html image91.png
<center><em>"Extrusion" button</em></center>
The following dialog box will appear:
<li>Click the \b Apply or \b OK button.</li>
</ol>
-\image html image77.jpg
+\image html image77.jpg "The mesh with an edge selected for extrusion"
-\image html image76.jpg
+\image html image76.jpg "The mesh with extruded edge"
<br><b>See Also</b> a sample TUI Script of an
\ref tui_extrusion "Extrusion" operation.
<li>From the \b Modification menu choose the <b>Extrusion along a
path</b> item or click <em>"Extrusion along a path"</em> button in the toolbar.
-\image html image101.gif
+\image html image101.png
<center><em>"Extrusion along a path" button</em></center>
The following dialog box will appear:
right, add them to the list of angles at the left by pressing the <em>"Add"</em>
button and remove them from the list by pressing the <em>"Remove"</em> button.
-\image html image105.gif
+\image html add.png
<center><em>"Add" button</em></center>
-\image html image106.gif
+\image html remove.png
<center><em>"Remove" button</em></center>
<b>Linear variation of the angles</b> option allows defining the angle of gradual rotation for the whole path.
\page grouping_elements_page Grouping elements
+In Mesh module it is possible to \subpage creating_groups_page "create groups of mesh elements":
+nodes, edges, faces or volumes:
<ul>
-<li>\subpage creating_groups_page</li>
-<li>\subpage editing_groups_page</li>
-<li>\subpage using_operations_on_groups_page</li>
-<li>\subpage constructing_groups_of_specific_elements_page</li>
-<li>\subpage deleting_groups_page</li>
-<li>\subpage selection_filter_library_page</li>
+<li> by selecting the elements of the specified kind by their IDs or
+directly on the presentation in the VTK viewer - <b>Standalone group</b> tab of <b>Create group</b>
+dialog.</li>
+<li> by creating a group of elements of the selected type from all
+such elements of the chosen geometrical object - <b>Group on
+geometry</b> tab of <b>Create group</b> dialog.</li>
+<li> by creating several groups of elements (nodes,
+edges, faces and volumes) from the chosen submesh - using <b>Mesh -> Construct
+Group</b> Menu item. In this case groups of elements are created automatically.</li>
</ul>
+The created groups can be later:
+
+<ul>
+<li>\subpage editing_groups_page "Edited"</li>
+<li>\subpage using_operations_on_groups_page "Subjected to Boolean operations", or</li>
+<li>\subpage deleting_groups_page "Deleted"</li>
+</ul>
+
+An important tool, providing filters for creation of \b Standalone
+groups is \subpage selection_filter_library_page</li>.
+
+
*/
\page importing_exporting_meshes_page Importing and exporting meshes
\n In MESH there is a functionality allowing importation/exportation
-of meshes from \b MED, \b UNV (I-DEAS 10), \b DAT (Nastran) and STL format files.
+of meshes from \b MED, \b UNV (I-DEAS 10), \b DAT (Nastran) and STL
+format files.
+
<em>To import a mesh:</em>
select the corresponding format (MED, UNV and DAT) of the file containing
your mesh.</li>
<li>In the standard <b>Search File</b> dialog box find the file for
-importation.</li>
+importation. It is possible to select multiple files to be imported all at once. </li>
+
<li>Click the \b OK button.</li>
</ol>
/*!
-\mainpage SMESH Module Reference Documentation
+\mainpage Introduction to MESH
-<ul>
-<li>\subpage introduction_to_mesh_page</li>
-<li>\subpage running_mesh_module_page</li>
-<li>\subpage introduction_to_mesh_python_page</li>
-<li>\subpage creating_meshes_page</li>
-<ul>
-<li>\ref about_meshes_page</li>
-<li>\ref importing_exporting_meshes_page</li>
-<li>\ref constructing_meshes_page</li>
-<li>\ref defining_algos_page</li>
-<ul>
-<li>\ref basic_meshing_algos_page</li>
-<li>\ref projection_algos_page</li>
-<li>\ref radial_prism_algo_page</li>
-<li>\ref segments_around_vertex_algo_page</li>
-<li>\ref prism_3d_algo_page</li>
-</ul>
-<li>\ref defining_hypo_page</li>
-<ul>
-<li>\ref about_hypo_page</li>
-<li>\ref a1d_meshing_hypo_page</li>
-<li>\ref a2d_meshing_hypo_page</li>
-<li>\ref max_element_volume_hypo_page</li>
-<li>\ref netgen_2d_3d_hypo_page</li>
-<li>\ref ghs3d_hypo_page</li>
-<li>\ref blsurf_hypo_page</li>
-<li>\ref additional_hypo_page</li>
-</ul>
-<li>\ref constructing_submeshes_page</li>
-<li>\ref building_compounds_page</li>
-<li>\ref editing_meshes_page</li>
-</ul>
-<li>\subpage viewing_meshes_page</li>
-<ul>
-<li>\ref viewing_meshes_overview_page</li>
-<li>\ref mesh_infos_page</li>
-<li>\ref numbering_page</li>
-<li>\ref display_mode_page</li>
-<li>\ref display_entity_page</li>
-<li>\ref transparency_page</li>
-<li>\ref clipping_page</li>
-</ul>
-<li>\subpage quality_controls_page</li>
-<ul>
-<li>\ref about_quality_controls_page</li>
-<li>\ref free_borders_page</li>
-<li>\ref borders_at_multi_connection_page</li>
-<li>\ref length_page</li>
-<li>\ref free_edges_page</li>
-<li>\ref length_2d_page</li>
-<li>\ref borders_at_multi_connection_2d_page</li>
-<li>\ref area_page</li>
-<li>\ref taper_page</li>
-<li>\ref aspect_ratio_page</li>
-<li>\ref minimum_angle_page</li>
-<li>\ref warping_page</li>
-<li>\ref skew_page</li>
-<li>\ref aspect_ratio_3d_page</li>
-<li>\ref volume_page</li>
-</ul>
-<li>\subpage grouping_elements_page</li>
-<ul>
-<li>\ref creating_groups_page</li>
-<li>\ref editing_groups_page</li>
-<li>\ref using_operations_on_groups_page</li>
-<li>\ref constructing_groups_of_specific_elements_page</li>
-<li>\ref deleting_groups_page</li>
-<li>\ref selection_filter_library_page</li>
-</ul>
-<li>\subpage modifying_meshes_page</li>
-<ul>
-<li>\ref adding_nodes_and_elements_page</li>
-<li>\ref adding_quadratic_elements_page</li>
-<li>\ref removing_nodes_and_elements_page</li>
-<li>\ref renumbering_nodes_and_elements_page</li>
-<li>\ref transforming_meshes_page</li>
-<ul>
-<li>\ref translation_page</li>
-<li>\ref rotation_page</li>
-<li>\ref symmetry_page</li>
-<li>\ref sewing_meshes_page</li>
-<li>\ref merging_nodes_page</li>
-<li>\ref merging_elements_page</li>
-</ul>
-<li>\ref moving_nodes_page</li>
-<li>\ref mesh_through_point_page</li>
-<li>\ref diagonal_inversion_of_elements_page</li>
-<li>\ref uniting_two_triangles_page</li>
-<li>\ref uniting_set_of_triangles_page</li>
-<li>\ref changing_orientation_of_elements_page</li>
-<li>\ref cutting_quadrangles_page</li>
-<li>\ref smoothing_page</li>
-<li>\ref extrusion_page</li>
-<li>\ref extrusion_along_path_page</li>
-<li>\ref revolution_page</li>
-<li>\ref pattern_mapping_page</li>
-<li>\ref convert_to_from_quadratic_mesh_page</li>
-</ul>
-<li>\subpage smeshpy_interface_page</li>
-<li>\subpage tui_scripts_page</li>
-<ul>
-<li>\ref tui_creating_meshes_page</li>
-<li>\ref tui_viewing_meshes_page</li>
-<li>\ref tui_defining_hypotheses_page</li>
-<li>\ref tui_quality_controls_page</li>
-<li>\ref tui_grouping_elements_page</li>
-<li>\ref tui_modifying_meshes_page</li>
-<li>\ref tui_transforming_meshes_page</li>
-</ul>
+\image html a-viewgeneral.png
+
+\n \b MESH module of SALOME is destined for:
+<ul>
+<li>\ref importing_exporting_meshes_page "import and export of meshes in MED format";</li>
+<li>\subpage about_meshes_page "meshing geometrical models"
+previously created or imported by the Geometry component; </li>
+<li>\subpage viewing_meshes_overview_page "viewing created meshes" in
+the VTK viewer;</li>
+<li>\subpage grouping_elements_page "creating groups of mesh elements";</li>
+<li>applying to meshes \subpage quality_page "Quality Controls" ,
+allowing to highlight important elements:
+<li>\subpage modifying_meshes_page "modifying meshes" with a vast
+array of dedicated operations.</li>
</ul>
-*/
+Almost all mesh module functionalities are accessible via
+\subpage smeshpy_interface_page "Mesh module Python interface".
+
+\image html image7.jpg "Example of MESH module usage for engineering tasks"
+
+*/
\ No newline at end of file
+++ /dev/null
-/*!
-
-\page introduction_to_mesh_page Introduction to MESH
-
-\n \b MESH module of SALOME is destined for:
-<ul>
-<li>\ref importing_exporting_meshes_page "import and export of meshes in MED format",</li>
-<li>\ref constructing_meshes_page "meshing geometrical models"
-previously created or imported by the GEOM component. MESH module
-allows to apply 1D, 2D, 3D meshing algorithms and a set of hypotheses:
-<ul>
-<li>\ref arithmetic_1d_anchor "Arithmetic 1D"</li>
-<li>\ref average_length_anchor "Average Length"</li>
-<li>\ref deflection_1d_anchor "Deflection 1D"</li>
-<li>\ref number_of_segments_anchor "Number of segments"</li>
-<li>\ref start_and_end_length_anchor "Start and end length"</li>
-<li>\ref automatic_length_anchor "Automatic Length"</li>
-<li>\ref max_element_area_anchor "Max Element Area"</li>
-<li>\ref length_from_edges_anchor "Length from Edges"</li>
-<li>\ref quadrangle_preference_anchor "Quadrangle Preference"</li>
-<li>\ref triangle_preference_anchor "Triangle Preference"</li>
-<li>\ref max_element_volume_hypo_page "Max Element Volume"</li>
-</ul>
-</li>
-<li>modification of locally generated meshes by
-<ul>
-<li>\ref adding_nodes_and_elements_page "Addition" of nodes and elements</li>
-<li>\ref removing_nodes_and_elements_page "Removal" of nodes and elements </li>
-</ul>
-</li>
-<li>\ref creating_groups_page "grouping mesh elements" and
-\ref using_operations_on_groups_page "performing operations on these groups"</li>
-<li>\ref about_quality_controls_page "quality control" of meshes basing on a set of definite criteria -
-
-<b>for edges:</b>
-<ul>
-<li>\ref length_page "Length of edges"</li>
-<li>\ref borders_at_multi_connection_page "Borders at multi-connection"</li>
-<li>\ref free_borders_page "Free borders"</li>
-</ul>
-
-<b>for faces:</b>
-<ul>
-<li>\ref area_page "Area"</li>
-<li>\ref free_edges_page "Free edges"</li>
-<li>\ref borders_at_multi_connection_2d_page "Borders at multi-connection 2D"</li>
-<li>\ref length_2d_page "Length 2D"</li>
-<li>\ref minimum_angle_page "Minimum angle"</li>
-<li>\ref taper_page "Taper"</li>
-<li>\ref aspect_ratio_page "Aspect Ratio"</li>
-<li>\ref warping_page "Warping"</li>
-<li>\ref skew_page "Skew"</li>
-</ul>
-
-<b>for solids:</b>
-<ul>
-<li>\ref aspect_ratio_3d_page "Aspect ratio 3D"</li>
-<li>\ref volume_page "Volume"</li>
-</ul>
-</li>
-</ul>
-
-\image html image7.jpg
-
-*/
\ No newline at end of file
+++ /dev/null
-/*!
-
-\page introduction_to_mesh_python_page Introduction to MESH module python interface
-
-\n Package smesh provides a standard API for creation and edition of meshes.
-\n Below you can see an example of usage of the package smesh for 3d mesh generation.
-
-<h2>Example of 3d mesh generation with NETGEN:</h2>
-
-\n from geompy import *
-\n import smesh
-
-<b># Geometry</b>
-\n <b># an assembly of a box, a cylinder and a truncated cone meshed with tetrahedral</b>.
-
-<b># Define values</b>
-\n name = "ex21_lamp"
-\n cote = 60
-\n section = 20
-\n size = 200
-\n radius_1 = 80
-\n radius_2 = 40
-\n height = 100
-
-<b># Build a box</b>
-\n box = MakeBox(-cote, -cote, -cote, +cote, +cote, +cote)
-
-<b># Build a cylinder</b>
-\n pt1 = MakeVertex(0, 0, cote/3)
-\n di1 = MakeVectorDXDYDZ(0, 0, 1)
-\n cyl = MakeCylinder(pt1, di1, section, size)
-
-<b># Build a truncated cone</b>
-\n pt2 = MakeVertex(0, 0, size)
-\n cone = MakeCone(pt2, di1, radius_1, radius_2, height)
-
-<b># Fuse </b>
-\n box_cyl = MakeFuse(box, cyl)
-\n piece = MakeFuse(box_cyl, cone)
-
-<b># Add in study</b>
-\n addToStudy(piece, name)
-
-<b># Create a group of faces</b>
-\n group = CreateGroup(piece, ShapeType["FACE"])
-\n group_name = name + "_grp"
-\n addToStudy(group, group_name)
-\n group.SetName(group_name)
-
-<b># Add faces in the group</b>
-\n faces = SubShapeAllIDs(piece, ShapeType["FACE"])
-\n UnionIDs(group, faces)
-
-<b># Create a mesh</b>
-
-<b># Define a mesh on a geometry</b>
-\n tetra = smesh.Mesh(piece, name)
-
-<b># Define 1D hypothesis</b>
-\n algo1d = tetra.Segment()
-\n algo1d.LocalLength(10)
-
-<b># Define 2D hypothesis</b>
-\n algo2d = tetra.Triangle()
-\n algo2d.LengthFromEdges()
-
-<b># Define 3D hypothesis</b>
-\n algo3d = tetra.Tetrahedron(smesh.NETGEN)
-\n algo3d.MaxElementVolume(100)
-
-<b># Compute the mesh</b>
-\n tetra.Compute()
-
-<b># Create a groupe of faces</b>
-\n tetra.Group(group)
-
-*/
<li>Choose <b>Controls > Length 2D</b> or click <em>"Length 2D"</em>
button in the toolbar.
-\image html image34.gif
+\image html image34.png
<center><em>"Length 2D" button</em></center>
Your mesh will be displayed in the viewer with its elements colored according to the applied mesh quality control criterion:
\n This functionality allows to merge coincident elements of a mesh
selectable in the dialog box.
+
+\image html mergeelems_ico.png "Merge elements button"
+
+
\image html mergeelems.png
<ul>
</ul></li>
<li><b>Edit selected group</b> list allows editing the selected group:
<br><br>
- \image html add.gif
+ \image html add.png
<center>adds to the group the element selected in the viewer.</center>
<br>
- \image html remove.gif
+ \image html remove.png
<center>removes from the group the selected element.</center>
<br>
- \image html sort.gif
+ \image html sort.png
<center>moves the selected element to the first position in the
group. This means that all other elements will be merged into this
one.</center>
\n This functionality allows user to detect groups of coincident nodes
with desirable tolerance, edit these groups and merge.
+\image html mergenodes_ico.png "Merge nodes button"
+
<em>To merge nodes of your mesh:</em>
<ol>
<li>From the \b Modification choose \b Transformation and from its
<li><b>Edit selected group</b> list allows editing the selected
group:
<br><br>
-\image html add.gif
+\image html add.png
<center>adds to the group the node selected in the viewer.</center>
<br>
-\image html remove.gif
+\image html remove.png
<center>removes from the group the selected node.</center>
<br>
-\image html sort.gif
+\image html sort.png
<center>moves the selected node to the first position in the
group. This means that all other nodes will be merged into this
one.</center><br>
<li>To confirm your choice click \b Apply or <b>Apply and Close</b> button.</li>
</ol>
-\image html merging_nodes1.png
+\image html merging_nodes1.png "The initial obgect"
-\image html merging_nodes2.png
+\image html merging_nodes2.png "The object has been merged with a very big tolerance"
<br><b>See Also</b> a sample TUI Script of a
\ref tui_merging_nodes "Merge Nodes" operation.
from the \b Mesh menu or click <em>"Standard Mesh Infos"</em> button
in the toolbar.
-\image html image49.gif
+\image html image49.png
<center><em>"Standard Mesh Infos" button</em></center>
The following information will be displayed:
<li>Choose <b>Controls > Minimum angle</b> or click <em>"Minimum Angle"</em> button.
-\image html image38.gif
+\image html image38.png
<center><em>"Minimum Angle" button</em></center>
Your mesh will be displayed in the viewer with its elements colored
\page modifying_meshes_page Modifying meshes
+Salome provides an extremely vast spectre of mesh modification and
+transformation operations, giving the possibility to:
+
<ul>
-<li>\subpage adding_nodes_and_elements_page</li>
-<li>\subpage adding_quadratic_elements_page</li>
-<li>\subpage removing_nodes_and_elements_page</li>
-<li>\subpage renumbering_nodes_and_elements_page</li>
-<li>\subpage transforming_meshes_page</li>
-<ul>
-<li>\ref translation_page</li>
-<li>\ref rotation_page</li>
-<li>\ref symmetry_page</li>
-<li>\ref sewing_meshes_page</li>
-<li>\ref merging_nodes_page</li>
-<li>\ref merging_elements_page</li>
-</ul>
-<li>\subpage moving_nodes_page</li>
-<li>\subpage mesh_through_point_page</li>
-<li>\subpage diagonal_inversion_of_elements_page</li>
-<li>\subpage uniting_two_triangles_page</li>
-<li>\subpage uniting_set_of_triangles_page</li>
-<li>\subpage changing_orientation_of_elements_page</li>
-<li>\subpage cutting_quadrangles_page</li>
-<li>\subpage smoothing_page</li>
-<li>\subpage extrusion_page</li>
-<li>\subpage extrusion_along_path_page</li>
-<li>\subpage revolution_page</li>
-<li>\subpage pattern_mapping_page</li>
-<li>\subpage convert_to_from_quadratic_mesh_page</li>
+<li>\subpage adding_nodes_and_elements_page "Add" mesh elements from
+nodes to polyhedrons at an arbitrary place in the mesh.</li>
+<li>\subpage adding_quadratic_elements_page "Add quadratic" mesh
+elements (used in qyadratic meshes) from quadratic nodes
+nodes to quadratic polyhedrons at an arbitrary place in the mesh.</li>
+<li>\subpage removing_nodes_and_elements_page "Remove" any existing
+mesh elements.</li>
+<li>\subpage renumbering_nodes_and_elements_page "Renumber" nodes and
+elements of the mesh.</li>
+<li>\subpage translation_page "Translate" in the indicated direction the mesh or some of
+its elements.</li>
+<li>\subpage rotation_page "Rotate" by the indicated axis and angle
+the mesh or some of its elements.</li>
+<li>Create a \subpage symmetry_page "symmetrical copy" of the mesh
+through a point or a vector of symmetry.</li>
+<li>Unite meshes by \subpage sewing_meshes_page "sewing" free borders,
+conform free borders, border to side or side elements.</li>
+<li>\subpage merging_nodes_page "Merge Notes", considered coincident
+within the indicated tolerance.</li>
+<li>\subpage merging_elements_page "Merge Elements", considered coincident
+within the indicated tolerance.</li>
+<li>\subpage moving_nodes_page "Move Nodes" to an arbitrary location
+with consequent transformation of all adjacent elements and edges.</li>
+<li>\subpage mesh_through_point_page "Make node at a point", existing
+or created anew.</li>
+<li>\subpage diagonal_inversion_of_elements_page "Invert an edge" between neighboring triangles.</li>
+<li>\subpage uniting_two_triangles_page "Unite two triangles".</li>
+<li>\subpage uniting_set_of_triangles_page "Unite several adjacent triangles".</li>
+<li>\subpage changing_orientation_of_elements_page "Change orientation"
+ of the selected elements.</li>
+<li>\subpage cutting_quadrangles_page "Cut a quadrangle" into two triangles.</li>
+<li>\subpage smoothing_page "Smooth" elements,reducung distortions in
+them by adjusting the locations of element corners.</li>
+<li>Create an \subpage extrusion_page "extrusion" along a vector.</li>
+<li>Create an \subpage extrusion_along_path_page "extrusion along a path".</li>
+<li>Create an edge or a surface by \subpage revolution_page "revolution"
+of the selected node or edge.</li>
+<li>Apply \subpage pattern_mapping_page "pattern mapping".</li>
+<li>\subpage convert_to_from_quadratic_mesh_page "Convert regular mesh to quadratic",
+or vice versa.</li>
</ul>
*/
\ No newline at end of file
<li>From the \b Modification menu choose the <b>Move node</b> item or
click <em>"Move Node"</em> button in the toolbar.
-\image html image67.gif
+\image html image67.png
<center><em>"Move Node" button</em></center>
The following dialog box shall appear:
<li>Click the \b Apply or <b>Apply and Close</b> button.</li>
</ol>
-\image html moving_nodes1.png
+\image html moving_nodes1.png "The initial mesh"
-\image html moving_nodes2.png
+\image html moving_nodes2.png "The node has been moved, transforming all adjacent edges"
<br><b>See Also</b> a sample TUI Script of a
\ref tui_moving_nodes "Moving Nodes" operation.
\page numbering_page Numbering
-<br><h2>Displaying nodes numbers</h2>
+<br><h2>Displaying node numbers</h2>
In MESH you can display the ID numbers of all nodes of your mesh in
the viewer.
pop-up menu choose <b>Numbering > Display Nodes #</b>.</li>
</ol>
-It will look like as follows:
+\image html image96.jpg "Displayed node numbers"
-\image html image96.jpg
-
-<br><h2>Displaying elements numbers</h2>
+<br><h2>Displaying element numbers</h2>
In MESH you can display the ID numbers of all meshing elements
composing your mesh in the viewer.
pop-up menu choose <b>Numbering > Display Elements #</b>.</li>
</ol>
-It will look like as follows:
-
-\image html image95.jpg
+\image html image95.jpg "Displayed element numbers"
*/
From the \b Modification menu choose the <b>Pattern Mapping</b> item or click
<em>"Pattern mapping"</em> button in the toolbar.
-\image html image98.gif
+\image html image98.png
<center><em>"Pattern mapping" button</em></center>
The following dialog box shall appear:
The opposing faces can be meshed with either quadrangles or triangles,
while the side faces should be meshed with quadrangles only.
-\image html image157.gif
+\image html image157.gif "Prism with 3D extrusion meshing".
As you can see, the <b>3D extrusion</b> algorithm permits to build and to
have in the same 3D mesh such elements as hexahedrons, prisms and
\n Projection algorithms allow to define the mesh of a geometrical
object by the projection of another already meshed geometrical object.
-<b>Projection 1D</b> algorithm permits to define the mesh of an edge
+<b>Projection 1D</b> algorithm allows to define the mesh of an edge
(or group of edges)
by the projection of another already meshed edge (or group of edges).
\n To apply this algorithm select the edge to be meshed (indicated in
\image html projection_1d.png
-In this menu you can define the \b Name of the algorithm, the algeady
+In this menu you can define the \b Name of the algorithm, the already
meshed source \b Edge and the \b Mesh (optional, use it if there are several
different meshes on the same edge). It could also be necessary to
define the orientation of edges, which is done by indicating the
<b>Target Vertex</b> being the first point of the created \b Edge. For
a group of edges, <b>Source</b> and <b>Target</b> vertices should be
shared by only one edge of the group. If <b>Source</b> and
-<b>Target</b> vectors are specified, the elements of the group must be ajacent.
+<b>Target</b> vertices are specified, the elements of the group must be ajacent.
-\n <b>Projection 2D</b> algorithm permits to define the mesh of a face
+\n <b>Projection 2D</b> algorithm allows to define the mesh of a face
(or group of faces) by the
projection of another already meshed face (or group of faces). This
algorithm works only
\image html projection_2d.png
-In this menu you can define the \b Name of the algorithm, the algeady
+In this menu you can define the \b Name of the algorithm, the already
meshed source \b Face and the \b Mesh (optional, use it if there are several
different meshes on the same face). It could also be necessary to
define the orientation of mesh on the face, which is done by
source face, and two <b>Target Vertices</b>, which belong to the same edge of
the created \b Face.
-\n <b>Projection 3D</b> algorithm permits to define the mesh of a shape by
+\n <b>Projection 3D</b> algorithm allows to define the mesh of a shape by
the projection of another already meshed shape. This algorithm works
only if all faces and edges of the target face have been meshed as 1D
Projections of the faces and edges of the source face. Another
\image html projection_3d.png
-In this menu you can define the \b Name of the algorithm, the algeady
+In this menu you can define the \b Name of the algorithm, the already
meshed source <b>3D shape</b> and the \b Mesh (optional, use it if there are
several different meshes on the same shape). It could also be
necessary to define the orientation of mesh on the shape, which is
+++ /dev/null
-/*!
-
-\page quality_controls_page Quality controls
-
-<ul>
-<li>\subpage about_quality_controls_page</li>
-<li>\subpage free_borders_page</li>
-<li>\subpage borders_at_multi_connection_page</li>
-<li>\subpage length_page</li>
-<li>\subpage free_edges_page</li>
-<li>\subpage length_2d_page</li>
-<li>\subpage borders_at_multi_connection_2d_page</li>
-<li>\subpage area_page</li>
-<li>\subpage taper_page</li>
-<li>\subpage aspect_ratio_page</li>
-<li>\subpage minimum_angle_page</li>
-<li>\subpage warping_page</li>
-<li>\subpage skew_page</li>
-<li>\subpage aspect_ratio_3d_page</li>
-<li>\subpage volume_page</li>
-</ul>
-
-*/
\ No newline at end of file
\note Be careful while removing nodes because if you remove a definite
node of your mesh all adjacent elements will be also deleted.
-\image html remove_nodes1.png
-
-\image html remove_nodes2.png
-
<br>
\anchor removing_elements_anchor
<h2>Removing elements</h2>
<li>Click \b Apply or <b>Apply and Close</b> to confirm deletion of the specified elements.</li>
</ol>
-\image html remove_elements1.png
-
-\image html remove_elements2.png
+\image html remove_nodes1.png "The initial mesh"
+\image html remove_nodes2.png "The mesh with some elements removed"
<br>
\anchor clear_mesh_anchor
choose the \b Nodes item or click <em>"Renumbering nodes"</em> button
in the toolbar.
-\image html image63.gif
+\image html image63.png
<center><em>"Renumbering nodes" button</em></center>
The following dialog box will appear:
choose the \b Elements item or click <em>"Renumbering elements"</em>
button in the toolbar.
-\image html image64.gif
+\image html image64.png
<center><em>"Renumbering elements" button</em></center>
The following dialog box will appear:
<li>From the \b Modification menu choose the \b Revolution item or click
<em>"Revolution"</em> button in the toolbar.
-\image html image92.gif
+\image html image92.png
<center><em>"Revolution" button</em></center>
The following dialog box shall appear:
<ul> <li> Angle by Step - the elements are extruded by the specified angle at each step (i.e. for Angle=30 and Number of Steps=2, the elements will be extruded
by 30 degrees twice for a total of 30*2=60)</li>
-\image html revolutionsn2.png
+\image html revolutionsn2.png "Example of Revolution with Angle by Step"
<li> Total Angle - the elements are extruded by the specified angle only once and the number of steps defines the number of iterations
(i.e.for Angle=30 and Number of Steps=2, the elements will be extruded by 30/2=15 degrees twice for a total of 30). </li>
-\image html revolutionsn1.png
+\image html revolutionsn1.png "Example of Revolution with Total Angle"
</ul>
<li>tolerance of rotation</li>
\page rotation_page Rotation
-\n This geometrical operation allows to rotate in space your mesh or
+\n This operation allows to rotate in space your mesh or
some of its elements.
+\image html rotation_ico.png "Rotation button"
+
<em>To rotate your mesh:</em>
\par
From the \b Modification choose \b Transformation and from its sub-menu
\par
-\image html rotation1.png
+\image html rotation1.png "The initial mesh"
-\image html rotation2.png
+\image html rotation2.png "The rotated mesh"
<br><b>See Also</b> a sample TUI Script of a
\ref tui_rotation "Rotation" operation.
+++ /dev/null
-/*!
-
-\page running_mesh_module_page Running MESH module
-
-\n To start MESH module in SALOME click "Mesh" icon in the "Modules" toolbar or
-select \b Mesh from the Choose box.
-
-\image html image25.jpg
-<center><em>"Mesh" icon</em></center>
-
-The desktop of the SALOME platform will be updated with additional
-toolbars and menus related to the \b MESH component .
-
-\image html a-viewgeneral.png
-
-*/
\ No newline at end of file
<li>\ref side_elements_anchor "Side elements"</li>
</ul>
+\image html sewing.png "Sewing button"
+
<em>To sew elements of different meshes:</em>
<ol>
<li>From the \b Modification menu choose the \b Transformation item
fifth of minimum length of adjacent face edges on the borders.</li>
</ol>
-\image html image22.jpg
+\image html image22.jpg "Sewing free borders"
<b>See Also</b> a sample TUI Script of a
\ref tui_sew_free_borders "Sew Free Borders" operation.
the first border and two points on the second one. User can select
these nodes in 3D viewer or define node by its id.
-\image html image22.jpg
+\image html image23.jpg "Sewing conform free borders"
<b>See Also</b> a sample TUI Script of a
\ref tui_sew_conform_free_borders "Sew Conform Free Borders"
viewer or define node by its id.</li>
</ol>
-\image html image30.jpg
+\image html image30.jpg "Sewing border to side"
<b>See Also</b> a sample TUI Script of a
\ref tui_sew_meshes_border_to_side "Sew Border to Side" operation.
Sewing algorithm finds and merges the corresponding nodes starting
from the specified ones.
-\image html image31.jpg
+\image html image31.jpg "Step-by-step sewing process"
-\image html image32.jpg
+\image html image32.jpg "The result of side elements sewing"
For sewing side elements you should define elements for sewing and two
nodes for merging on the each side. User can select these elements and
<li>Choose <b>Controls > Skew</b> or click <em>"Skew"</em> button of the toolbar.
-\image html image40.gif
+\image html image40.png
<center><em>"Skew" button </em></center>
Your mesh will be displayed in the viewer with its elements colored
/*!
-\page smeshpy_interface_page Python interface smesh.py
+\page smeshpy_interface_page Python interface
\n Python package smesh defines several classes, destined for easy and
clear mesh creation and edition.
\n others are based on commercial meshers:
- GHS3D(3D), BLSURF(2D).
-\n To add hypotheses, use the interfaces, provided by the assigned algorithms.
+\n To add hypotheses, use the interfaces, provided by the assigned
+algorithms.
+
+\n Below you can see an example of usage of the package smesh for 3d mesh generation.
+
+<h2>Example of 3d mesh generation with NETGEN:</h2>
+
+\n from geompy import *
+\n import smesh
+
+<b># Geometry</b>
+\n <b># an assembly of a box, a cylinder and a truncated cone meshed with tetrahedral</b>.
+
+<b># Define values</b>
+\n name = "ex21_lamp"
+\n cote = 60
+\n section = 20
+\n size = 200
+\n radius_1 = 80
+\n radius_2 = 40
+\n height = 100
+
+<b># Build a box</b>
+\n box = MakeBox(-cote, -cote, -cote, +cote, +cote, +cote)
+
+<b># Build a cylinder</b>
+\n pt1 = MakeVertex(0, 0, cote/3)
+\n di1 = MakeVectorDXDYDZ(0, 0, 1)
+\n cyl = MakeCylinder(pt1, di1, section, size)
+
+<b># Build a truncated cone</b>
+\n pt2 = MakeVertex(0, 0, size)
+\n cone = MakeCone(pt2, di1, radius_1, radius_2, height)
+
+<b># Fuse </b>
+\n box_cyl = MakeFuse(box, cyl)
+\n piece = MakeFuse(box_cyl, cone)
+
+<b># Add in study</b>
+\n addToStudy(piece, name)
+
+<b># Create a group of faces</b>
+\n group = CreateGroup(piece, ShapeType["FACE"])
+\n group_name = name + "_grp"
+\n addToStudy(group, group_name)
+\n group.SetName(group_name)
+
+<b># Add faces in the group</b>
+\n faces = SubShapeAllIDs(piece, ShapeType["FACE"])
+\n UnionIDs(group, faces)
+
+<b># Create a mesh</b>
+
+<b># Define a mesh on a geometry</b>
+\n tetra = smesh.Mesh(piece, name)
+
+<b># Define 1D hypothesis</b>
+\n algo1d = tetra.Segment()
+\n algo1d.LocalLength(10)
+
+<b># Define 2D hypothesis</b>
+\n algo2d = tetra.Triangle()
+\n algo2d.LengthFromEdges()
+
+<b># Define 3D hypothesis</b>
+\n algo3d = tetra.Tetrahedron(smesh.NETGEN)
+\n algo3d.MaxElementVolume(100)
+
+<b># Compute the mesh</b>
+\n tetra.Compute()
+
+<b># Create a groupe of faces</b>
+\n tetra.Group(group)
+
+\n Examples of Python scripts for all Mesh operations are available by
+the following links:
+
+<ul>
+<li>\subpage tui_creating_meshes_page</li>
+<li>\subpage tui_viewing_meshes_page</li>
+<li>\subpage tui_defining_hypotheses_page</li>
+<li>\subpage tui_quality_controls_page</li>
+<li>\subpage tui_grouping_elements_page</li>
+<li>\subpage tui_modifying_meshes_page</li>
+<li>\subpage tui_transforming_meshes_page</li>
+</ul>
+
*/
<li>In the \b Modification menu select the \b Smoothing item or click
<em>"Smoothing"</em> button in the toolbar.
-\image html image84.gif
+\image html image84.png
<center><em>"Smoothing" button</em></center>
The dialog box contains the following fields which should be
<li>Click the \b Apply or \b OK button to confirm the operation.</li>
</ol>
-\image html smoothing1.png
+\image html smoothing1.png "The initial mesh"
-\image html smoothing2.png
+\image html smoothing2.png "The smoothed mesh"
<br><b>See Also</b> a sample TUI Script of a
\ref tui_smoothing "Smoothing" operation.
\n This geometrical operation allows to perform a symmetrical copy of
your mesh or some of its elements.
+\image html symmetry.png "Symmetry button"
+
<em>To apply symmetry to your mesh:</em>
\par
From the \b Modification choose \b Transformation and from its
of two triangles separated by a diagonal. So it can be calculated only
for elements consisting of 4 nodes.
-\image html image25.gif
+\image html image25.png
<br><em>To apply the Taper quality criterion to your mesh:</em>
<li>Choose <b>Controls > Taper</b> or click <em>"Taper"</em> button in
the toolbar.
-\image html image36.gif
+\image html image36.png
<center><em>"Taper" button</em></center>
Your mesh will be displayed in the viewer with its elements colored
+++ /dev/null
-/*!
-
-\page transforming_meshes_page Transforming meshes
-
-<ul>
-<li>\subpage translation_page</li>
-<li>\subpage rotation_page</li>
-<li>\subpage symmetry_page</li>
-<li>\subpage sewing_meshes_page</li>
-<li>\subpage merging_nodes_page</li>
-<li>\subpage merging_elements_page</li>
-</ul>
-
-*/
\ No newline at end of file
\n This geometrical operation allows to translate in space your mesh
or some of its elements.
+\image html translation.png "Translation button"
+
<em>To translate your mesh:</em>
\par
From the \b Modification choose \b Transformation and from its
+++ /dev/null
-/*!
-
-\page tui_scripts_page TUI Scripts
-
-<ul>
-<li>\subpage tui_creating_meshes_page</li>
-<li>\subpage tui_viewing_meshes_page</li>
-<li>\subpage tui_defining_hypotheses_page</li>
-<li>\subpage tui_quality_controls_page</li>
-<li>\subpage tui_grouping_elements_page</li>
-<li>\subpage tui_modifying_meshes_page</li>
-<li>\subpage tui_transforming_meshes_page</li>
-</ul>
-
-*/
\ No newline at end of file
<li>In the \b Modification menu select the <b>Union of triangles</b>
item or click <em>"Union of triangles"</em> button in the toolbar.
-\image html image80.gif
+\image html image80.png
<center><em>"Union of triangles" button</em></center>
The following dialog box will appear:
If some selected triangle elements have no adjacent edges with one of
the others, the operation on these elements shall take no effect.
-\image html uniting_a_set_of_triangles1.png
+\image html uniting_a_set_of_triangles1.png "The chosen triangles"
-\image html uniting_a_set_of_triangles2.png
+\image html uniting_a_set_of_triangles2.png "The union of several triangles - several quadrangular cells are created"
<br><b>See Also</b> a sample TUI Script of a
\ref tui_uniting_set_of_triangles "Uniting a Set of Triangles" operation.
triangles</b> item or click <em>"Union of two triangles"</em> button
in the toolbar.
-\image html image71.gif
+\image html image71.png
<center><em>"Union of two triangles" button</em></center>
The following dialog box shall appear:
<li>Click the \b Apply or <b>Apply and Close</b> button.</li>
</ol>
-\image html uniting_two_triangles1.png
+\image html uniting_two_triangles1.png "The selected triangles"
-\image html uniting_two_triangles2.png
+\image html uniting_two_triangles2.png "The union of two triangles"
<br><b>See Also</b> a sample TUI Script of a
\ref tui_uniting_two_triangles "Uniting Two Triangles" operation.
+++ /dev/null
-/*!
-
-\page viewing_meshes_page Viewing meshes
-
-<ul>
-<li>\subpage viewing_meshes_overview_page</li>
-<li>\subpage mesh_infos_page</li>
-<li>\subpage numbering_page</li>
-<li>\subpage display_mode_page</li>
-<li>\subpage display_entity_page</li>
-<li>\subpage transparency_page</li>
-<li>\subpage clipping_page</li>
-</ul>
-
-*/
\ No newline at end of file
/*!
-\page viewing_meshes_overview_page Overview
+\page viewing_meshes_overview_page Viewing meshes
\n After definition of algorithms and hypotheses a new mesh is listed
in the Object Browser. Right-click on it and select \b Compute - the
<li><b>Hide all</b> - allows to hide all objects in the viewer.</li>
<li><b>Update</b> - refreshes the presentation of your mesh in the
Object Browser, applying all recent changes. </li>
-<li>\ref advanced_mesh_infos_anchor "Advanced Mesh Infos" - provides
-more detailed information about the mesh.</li>
-<li>\ref standard_mesh_infos_anchor "Standard Mesh Infos" - provides
-basic information about the mesh.</li>
+<li>\subpage mesh_infos_page "Mesh Infos" - provides
+information about the mesh.</li>
<li>\ref mesh_element_info_anchor "Mesh Element Info" - provides basic
information about the selected element of the mesh. </li>
-<li>\ref numbering_page "Numbering" - allows to display the ID
+<li>\subpage numbering_page "Numbering" - allows to display the ID
numbers of all meshing elements or nodes composing your mesh in the
viewer.</li>
-<li>\ref display_mode_page "Display Mode" - allows to select between
+<li>\subpage display_mode_page "Display Mode" - allows to select between
Wireframe, Shading and Nodes presentation.</li>
-<li>\ref display_entity_page "Display Entity" - allows to display
+<li>\subpage display_entity_page "Display Entity" - allows to display
Faces, Edges or both.</li>
+<li><b>Orientation of faces</b> - shows vectors of orientation of
+faces of the selected mesh</li>
<li><b>Colors / Size</b> - allows to select color and size of
meshes.</li>
-<li>\ref transparency_page "Transparency" - allows to change the
+<li>\subpage transparency_page "Transparency" - allows to change the
transparency of mesh elements.</li>
-<li>\ref clipping_page "Clipping" - allows to create cross-sections of the selected objects.</li>
+<li>\subpage clipping_page "Clipping" - allows to create cross-sections of the selected objects.</li>
<li>\ref about_quality_controls_page "Controls" - graphically
presents various information about meshes.</li>
<li><b>Hide</b> - allows to hide the selected mesh from the viewer.</li>
<li>Choose <b>Controls > Volume</b> or click <em>"Volume"</em> button
in the toolbar.
-\image html image145.gif
+\image html image145.png
<center><em>"Volume" button</em></center>
Your mesh will be displayed in the viewer with its elements colored
<li>Choose <b>Controls > Warping Angle</b> or click <em>"Warping angle"</em>
button of the toolbar.
-\image html image39.gif
+\image html image39.png
<center><em>"Warping angle" button</em></center>
Your mesh will be displayed in the viewer with its elements colored
