<h2>Adaptive hypothesis</h2>
<b>Adaptive</b> hypothesis allows to split edges into segments with a
-length that depends on curvature of edges and faces and is limited
-from up and down. In addition length of a segment depends on lengths
-of adjacent segments (that can't differ more than twice) and on
+length that depends on the curvature of edges and faces and is limited by <b>Min. Size</b>
+and <b>Max Size</b>. The length of a segment also depends on the lengths
+of adjacent segments (that can't differ more than twice) and on the
distance to close geometrical entities (edges and faces) to avoid
creation of narrow 2D elements.
\image html adaptive1d.png
-<b>Min size</b> parameter limits minimal segment size. <b>Max size</b>
-parameter defines length of segments on stright edges. \b Deflection
-parameter gives maximal distance of a segment from a curved edge.
+- <b>Min size</b> parameter limits the minimal segment size.
+- <b>Max size</b> parameter defines the length of segments on straight edges.
+- \b Deflection parameter gives maximal distance of a segment from a curved edge.
-\image html adaptive1d_sample_mesh.png "A geometry and a mesh generated on this geometry using Adaptive hypothesis and Netgen 2D algorithm - the size of mesh segments reflects size of geometrical features"
+\image html adaptive1d_sample_mesh.png "Adaptive hypothesis and Netgen 2D algorithm - the size of mesh segments reflects the size of geometrical features"
-<b>See Also</b> a \ref tui_1d_adaptive "sample TUI Script" that
-creates the mesh of the above image.
+<b>See Also</b> a \ref tui_1d_adaptive "sample TUI Script" that creates mesh of the above image.
<br>
\anchor arithmetic_1d_anchor
\page a2d_meshing_hypo_page 2D Meshing Hypotheses
-<br>
-<ul>
-<li>\ref max_element_area_anchor "Max Element Area"</li>
-<li>\ref length_from_edges_anchor "Length from Edges"</li>
-<li>\ref hypo_quad_params_anchor "Quadrangle parameters"</li>
-</ul>
+- \ref max_element_area_anchor "Max Element Area"
+- \ref length_from_edges_anchor "Length from Edges"
+- \ref hypo_quad_params_anchor "Quadrangle parameters"
-<br>
\anchor max_element_area_anchor
<h2>Max Element Area</h2>
\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
-operation.
+\ref tui_max_element_area "Maximum Element Area" hypothesis operation.
-<br>
\anchor length_from_edges_anchor
<h2>Length from Edges</h2>
<b>See Also</b> a sample TUI Script of a
\ref tui_length_from_edges "Length from Edges" hypothesis operation.
-<br>
\anchor hypo_quad_params_anchor
<h2>Quadrangle parameters</h2>
segments on opposite sides to define the algorithm of transition
between them. The following types are available:
-<ul>
-<li><b>Standard</b> is the default case, when both triangles and quadrangles
- are possible in the transition area along the finer meshed sides.</li>
-<li><b>Triangle preference</b> forces building only triangles in the
- transition area along the finer meshed sides.
- <i>This type corresponds to <b>Triangle Preference</b> additional
- hypothesis, which is obsolete now.</i></li>
-<li><b>Quadrangle preference</b> forces building only quadrangles in the
- transition area along the finer meshed sides. This hypothesis has a
- restriction: the total quantity of segments on all
- four sides of the face must be even (divisible by 2).</li>
- <i>This type corresponds to <b>Quadrangle Preference</b>
- additional hypothesis, which is obsolete now.</i></li>
-<li><b>Quadrangle preference (reversed)</b> works in the same way and
+- <b>Standard</b> is the default case, when both triangles and quadrangles
+ are possible in the transition area along the finer meshed sides.
+- <b>Triangle preference</b> forces building only triangles in the
+ transition area along the finer meshed sides.
+ \note This type corresponds to <b>Triangle Preference</b> additional hypothesis,
+ which is obsolete now.
+- <b>Quadrangle preference</b> forces building only quadrangles in the
+ transition area along the finer meshed sides. This hypothesis has a
+ restriction: the total quantity of segments on all
+ four sides of the face must be even (divisible by 2).
+ \note This type corresponds to <b>Quadrangle Preference</b> additional hypothesis,
+ which is obsolete now.
+- <b>Quadrangle preference (reversed)</b> works in the same way and
with the same restriction as <b>Quadrangle preference</b>, but
- the transition area is located along the coarser meshed sides.</li>
-<li><b>Reduced</b> type forces building only quadrangles and the transition
- between the sides is made gradually, layer by layer. This type has
- a limitation on the number of segments: one pair of opposite sides must have
- the same number of segments, the other pair must have an even difference
- between the numbers of segments on the sides. In addition, number
- of rows of faces between sides with different discretization
- should be enough for the transition. At the fastest transition
- pattern, three segments become one (see the image below), hence
- the least number of face rows needed to reduce from Nmax segments
- to Nmin segments is log<sub>3</sub>( Nmax / Nmin ). The number of
- face rows is equal to number of segments on each of equally
- discretized sides.
-\image html reduce_three_to_one.png "The fastest transition pattern: 3 to 1"
-</li>
-</ul>
+ the transition area is located along the coarser meshed sides.
+- <b>Reduced</b> type forces building only quadrangles and the transition
+ between the sides is made gradually, layer by layer. This type has
+ a limitation on the number of segments: one pair of opposite sides must have
+ the same number of segments, the other pair must have an even difference
+ between the numbers of segments on the sides. In addition, the number
+ of rows between sides with different discretization
+ should be enough for the transition. Following the fastest transition
+ pattern, three segments become one (see the image below), hence
+ the least number of face rows needed to reduce from Nmax segments
+ to Nmin segments is log<sub>3</sub>( Nmax / Nmin ). The number of
+ face rows is equal to the number of segments on each of equally
+ discretized sides.
+ \image html reduce_three_to_one.png "The fastest transition pattern: 3 to 1"
<b>See Also</b> a sample TUI Script of a
\ref tui_quadrangle_parameters "Quadrangle Parameters" hypothesis.
\page clipping_page Clipping
-\n Using this menu you can create cross-section views (clipping planes)
+\b Clipping allows creating cross-section views (clipping planes)
of your mesh.
-To start, click on the \em New button.
+It is available as a sub-item in the context menu of an active mesh.
-Now you must specify what mode of creating plane you want to choose:
-absolute or relative.
+To create a clipping plane, click on the \b New button in the dialog and choose how it is defined: by \b Absolute or \b Relative coordinates.
-<b>Absolute mode</b>
+<b>Absolute Coordinates</b>
\image html Clipping_Absolute.png
-- <b>Base point</b> - allows to define the coordinates of the base
+- <b>Base point</b> - allows defining the coordinates of the base
point for the clipping plane.
- <b>Reset</b> - returns the base point to coordinate origin.
-- <b>Direction</b> - allows to define the orientation of the
+- <b>Direction</b> - allows defining the orientation of the
clipping plane.
- - <b>Invert</b> - allows to select which part of the object will be
+ - <b>Invert</b> - allows selecting, which part of the object will be
removed and which will remain after clipping.
<b>Relative mode</b>
\image html Clipping_Relative.png
- \b Orientation ( ||X-Y, ||X-Z or ||Y-Z).
+
- \b Distance between the opposite extremities of the boundary box of
selected objects, if it is set to 0.5 the boundary box is split in two halves.
+
- \b Rotation (in angle degrees) <b>around X</b> (Y to Z) and <b>around
Y</b> (X to Z) (depending on the chosen Orientation)
-The parameters of cross-section:
-
-List of <b>meshes, sub-meshes and groups</b> to which the cross-section will be applied.
-
-<b>Select all</b> button allows to select and deselect all available
-objects at once.
-
-If the <b>Show preview</b> button is on, you can see the clipping plane
-in the <b>3D Viewer</b>.
+\image html before_clipping_preview.png "The preview plane and the cut object"
-\image html before_clipping.png "The plane and the cut object"
+The other parameters are available in both modes :
-Also there the possibility to interact directly with the clipping plane in 3D
-view with mouse. User can change the parameters of clipping plane by dialog data
-or by hand.
+- <b>OpenGL clipping</b> check-box allows choosing OpenGL native clipping, which clips the whole presentation. If it is unchecked, the clipping is done on the dataset i.e. only the visibility of separate mesh cells is changed (see the examples).
+- The List contains <b>Meshes, sub-meshes and groups</b> to which the cross-section will be applied.
+- <b>Select all</b> check-box allows to selecting and deselecting all available objects at once.
+- <b>Show preview</b> check-box shows the clipping plane in the <b>3D Viewer</b>.
+- <b>Auto Apply</b> check-box shows button is on, you can preview the
+cross-section in the <b>3D Viewer</b>.
-\image html before_clipping_preview.png "The preview plane and the cut object"
+It is also possible to interact with the clipping plane directly in 3D
+view using the mouse.
-If the <b>Auto Apply</b> button is on, you can preview the
-cross-section in the <b>3D Viewer</b>.
+To get a new object from \b Clipping, click \b Apply.
-Also, it is possible to specify the type of clipping: using dataset,
-i.e. it only changes the visibility of separate mesh cells or alternative
-clipping - an OpenGL native one, which clips overall presentation.
-For choosing use <b>OpenGL clipping</b> checkbox.
+<b>Examples:</b>
\image html dataset_clipping.png "The cross-section using dataset"
-
\image html opengl_clipping.png "The OpenGL cross-section"
-To get a new object from \b Clipping, click \b Apply.
*/
switching the mesh to Wireframe visualization mode or switching off
the visualization of faces and volumes (if any).
-<b>Bad Mesh to Group</b> button creates groups of the bad mesh entities,
-thus allowing you for more comfortable analysis of these entities.
+<b>Bad Mesh to Group</b> button creates groups of bad mesh entities
+to facilitate their analysis.
\image html show_bad_mesh.png
<em>Edges bounding a hole in the surface are shown in magenta using <b>Show
For example, you want to use standard algorithms to generate 1D and 3D
meshes and to create 2D mesh by your python code. Then you
<ol>
- <li> create a mesh object, assign an 1D algorithm,</li>
- <li> invoke \b Compute command, which computes an 1D mesh,</li>
+ <li> create a mesh object, assign a 1D algorithm,</li>
+ <li> invoke \b Compute command, which computes a 1D mesh,</li>
<li> assign <b>Use existing faces</b> and a 3D algorithm,</li>
<li> run your python code, which creates a 2D mesh,</li>
<li> invoke \b Compute command, which computes a 3D mesh.</li>
\page cutting_quadrangles_page Cutting quadrangles
-\n This operation allows cutting one or several quadrangle elements
-into two or four triangles.
+This operation allows cutting one or several quadrangle elements into two or four triangles.
<em>To cut quadrangles:</em>
-<ol>
-<li>Display a mesh, a 2D sub-mesh or a group of faces in the 3D viewer.</li>
-<li>In the \b Modification menu select the <b>Cutting of quadrangles</b> item or
+
+1) Display a mesh, a 2D sub-mesh or a group of faces in the 3D viewer.
+
+2) 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.png
\image html a-cuttingofquadrangles.png
-<ul>
-<li>The main list contains the list of quadrangles selected for cutting. You can
- click on an quadrangle in the 3D viewer and it will be highlighted (lock Shift
- keyboard button to select several quadrangles). Click \b Add button and the ID of
- this quadrangle will be added to the list. To remove a selected element or elements
- from the list click \b Remove button. <b>Sort list</b> button allows to sort the
- list of IDs. \b Filter button allows to apply a definite filter to the selection of
- quadrangles.</li>
-<li><b>Apply to all</b> check box allows to cut all quadrangles of the selected mesh,
- sub-mesh or group.</li>
-<li>\b Preview provides a preview of cutting in the viewer. It is disabled for <b>Cut
- into 4 triangles</b> as this cutting way implies no ambiguity.</li>
-</ul>
-
-<ul>
-<li>\b Criterion defines a cutting way.
-<ul>
-<li><b>Cut into 4 triangles</b> selects cutting the quadrangle into four triangles by
- inserting a new node at the center of quadrangle. The other options selects cutting
- the quadrangle into two triangles by connecting nodes of either of the two diagonals.
-<li><b>Use diagonal 1-3</b> and <b>Use diagonal 2-4</b> allows to specify the
- opposite corners which will be connected to form two new triangles.</li>
-<li><b>Use numeric functor</b> allows to choose a quality metric which will be
- optimized when choosing a diagonal for cutting a quadrangle.
- <ul>
- <li><b>Minimum diagonal</b> cuts by the shortest diagonal.</li>
- <li><b>Aspect Ratio</b> cuts by the diagonal splitting the quadrangle into
- triangles with \ref aspect_ratio_page "Aspect Ratio" closer to 1.</li>
- <li><b>Minimum Angle</b> cuts by the diagonal splitting the quadrangle into
- triangles with \ref minimum_angle_page "Minimum Angle" closer to 60
- degrees.</li>
- <li><b>Skew</b> cuts by the diagonal splitting the quadrangle into triangles
- with \ref skew_page "Skew" closer to 0.0 degrees.</li>
- </ul>
-</li>
-</ul>
-</li>
-<li><b>Select from</b> allows to choose a sub-mesh or an existing group whose
- quadrangle elements will be automatically added to the main list.</li>
-</ul>
-</li>
-<li>Click the \b Apply or <b>Apply and Close</b> button to confirm the operation.</li>
-</ol>
+- The main list contains the list of quadrangles selected for cutting. You can
+click on a quadrangle in the 3D viewer and it will be highlighted (lock Shift
+keyboard button to select several quadrangles):
+ - Click \b Add button and the ID of this quadrangle will be added to the list.
+ - To remove a selected element or elements from the list click \b Remove button.
+ - <b>Sort list</b> button allows sorting the list of IDs.
+ - \b Filter button allows applying a definite filter to the selection of quadrangles.
+- <b>Apply to all</b> check box allows cutting all quadrangles of the selected mesh, sub-mesh or group.
+- \b Preview provides a preview of cutting in the viewer. It is disabled for <b>Cut into 4 triangles</b> as this cutting way implies no ambiguity.
+- \b Criterion defines the way of cutting:
+ - <b>Cut into 4 triangles</b> allows cutting a quadrangle into four triangles by inserting a new node at the center of the quadrangle. The other options allow cutting a quadrangle into two triangles by connecting the nodes of a diagonal.
+ - <b>Use diagonal 1-3</b> and <b>Use diagonal 2-4</b> allow specifying the opposite corners, which will be connected to form two new triangles.
+ - <b>Use numeric functor</b> allows selecting in the field below a quality metric, which will be optimized when choosing a diagonal for cutting a quadrangle:
+ - <b>Minimum diagonal</b> cuts by the shortest diagonal.
+ - <b>Aspect Ratio</b> cuts by the diagonal splitting the quadrangle into triangles with \ref aspect_ratio_page "Aspect Ratio" closer to 1
+ - <b>Minimum Angle</b> cuts by the diagonal splitting the quadrangle into triangles with \ref minimum_angle_page "Minimum Angle" closer to 60 degrees.
+ - <b>Skew</b> cuts by the diagonal splitting the quadrangle into triangles with \ref skew_page "Skew" closer to 0.0 degrees.
+- <b>Select from</b> allows choosing a sub-mesh or an existing group, whose quadrangle elements will be automatically added to the main list.
+
+3) Click the \b Apply or <b>Apply and Close</b> button to confirm the operation.
\image html image52.jpg "The chosen quadrangular element"
\page double_nodes_page Duplicate Nodes or/and Elements
-\n This operation allows to duplicate nodes or/and elements of your mesh.
-Duplication of nodes can be useful to emulate a crack in the model.
+\n This operation allows duplicating mesh nodes or/and elements, which can be useful to emulate a crack in the model.
+
Duplication consists in creation of mesh element "equal" to existing ones.
<em>To duplicate nodes or/and elements:</em>
<br>
\anchor mode_without_elem_anchor
-<h2>Duplicate nodes only</h2>
-In this mode the dialog looks like:
+<h2>Duplicate nodes only</h2>
\image html duplicate01.png
<li><b>Group of nodes to duplicate</b> (<em>mandatory</em>): these
nodes will be duplicated.</li>
<li><b>Group of elements to replace nodes with new ones</b>
- (<em>optional</em>): the new nodes will replace the nodes to
- duplicate within these elements.</li>
+ (<em>optional</em>): the new nodes will replace the duplicated nodes within these elements.</li>
<li><b>Construct group with newly created nodes</b> option
- (<em>checked by default</em>): if checked - the group with just
+ (<em>checked by default</em>): if checked - the group with newly
created nodes will be built.</li>
</ul>
-A schema below explains the crack emulation using the node duplication.
+A schema below illustrates how the crack is emulated using the node duplication.
\image html crack_emulation_double_nodes.png "Crack emulation"
This schema shows a virtual crack in a 2D mesh created using this duplication
-mode. In this schema:
-- Black balls are <b>nodes to duplicate</b>.
+mode:
+- Black balls are <b>duplicated nodes</b>.
- Red balls are <b>new nodes</b>.
- <b>Elements to replace nodes with new ones</b> are marked with green.
-Note that in reality <b>nodes to duplicate</b> coincide with <b>new nodes</b>.
-
+Note that in the reality <b>duplicated nodes</b> coincide with <b>new nodes</b>.
<br>
\anchor mode_with_elem_anchor
-<h2>Duplicate nodes and border elements</h2>
-In this mode the dialog looks like:
+
+<h2>Duplicate nodes and border elements</h2>
\image html duplicate02.png
(<em>mandatory</em>): the new nodes will replace the nodes to
duplicate within these elements.</li>
<li><b>Construct group with newly created elements</b> option
- (<em>checked by default</em>): if checked - the group of just created
+ (<em>checked by default</em>): if checked - the group of newly created
elements will be built.</li>
<li><b>Construct group with newly created nodes</b> option
- (<em>checked by default</em>): if checked - the group of just
+ (<em>checked by default</em>): if checked - the group of newly
created nodes will be built.</li>
</ul>
\image html crack_emulation_double_nodes_with_elems.png "Crack emulation"
This schema shows a virtual crack in a 2D mesh created using this duplication
mode. In this schema:
-- Black segments are <b>elements to duplicate</b> (edges in 2D case).
-- Black balls (except the lowest one) are nodes of <b>elements to
- duplicate</b> that are duplicated.
-- The lowest black ball is a <b>node not to duplicate</b>.
-- Red balls are <b>creates nodes</b>.
+- Black segments are <b>duplicated elements</b> (edges in 2D case).
+- Black balls (except for the lowest one) are duplicated nodes of <b>duplicated elements</b>.
+- The lowest black ball is the <b>non-duplicated node</b>.
+- Red balls are <b>newly created nodes</b>.
- Red segments are <b>created elements</b> (edges).
- <b>Elements to replace nodes with new ones</b> are marked with green.
-Note that in reality <b>nodes to duplicate</b> coincide with <b>new nodes</b>.
+Note that in the reality <b>nodes to duplicate</b> coincide with <b>new nodes</b>.
<br>
In a 3D case, where <b>elements to duplicate</b> are faces, the edges
located at the "crack" (if any) are cloned automatically.
\anchor mode_elem_only_anchor
<h2>Duplicate elements only</h2>
-This mode just duplicates given elements, i.e. creates new elements on
-the same nodes as the given elements.
+This mode duplicates the given elements, i.e. creates new elements with the same nodes as the given elements.
+
<br>
-In this mode the dialog looks like:
+
\image html duplicate03.png
-Parameters to be defined in this mode:
<ul>
<li><b>Group of elements to duplicate</b> (<em>mandatory</em>): these
elements will be duplicated.</li>
<li><b>Construct group with newly created elements</b> option
- (<em>checked by default</em>): if checked - the group of just created
- elements will be built. A name of the created group starts from
+ (<em>checked by default</em>): if checked - the group of newly created
+ elements will be built. The name of the created group starts from
"DoubleElements".</li>
</ul>
-
<br><b>See Also</b> a sample TUI Script of a
\ref tui_duplicate_nodes "Duplicate nodes or/and elements" operation.
/*!
-\page extrusion_along_path_page Extrusion along a path
+\page extrusion_along_path_page Extrusion along Path
-\n In principle, <b>Extrusion along a path</b> works in the same way
+\n In principle, <b>Extrusion along Path</b> works in the same way
as \b Extrusion, the main difference is that we define not a vector,
but a path of extrusion which must be a 1D mesh or 1D sub-mesh.
To get an idea of how this algorithm works, examine several examples,
<center>The same, but using angles {45, -45, 45, -45, 45, -45, 45,
-45}</center>
-<br><em>To use Extrusion along a path:</em>
+<br><em>To use Extrusion along Path:</em>
<ol>
<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.
<li>specify the <b>IDs of the elements</b> which will be extruded
<ul>
-<li><b>Select the whole mesh, submesh or group</b> activating this
-checkbox; or</li>
-<li>choose mesh elements with the mouse in the 3D Viewer. It is
+<li><b>Select the whole mesh, sub-mesh or group</b> activating the corresponding check-box; or</li>
+<li>Choose mesh elements with the mouse in the 3D Viewer. It is
possible to select a whole area with a mouse frame; or</li>
-<li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
+<li>Input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
viewer; or</li>
<li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
</ul>
</li>
-<li>define the \b Path along which the elements will be extruded.<br>
+<li>Define the \b Path along which the elements will be extruded.<br>
Path definition consists of several elements:
<ul>
<li><b>Mesh or submesh</b> - 1D mesh or sub-mesh, along which proceeds the extrusion</li>
<li><b>Start node</b> - the start node. It is used to define the direction of extrusion </li>
</ul>
</li>
-<li>activate <b>Generate Groups</b> checkbox if it is necessary to copy the groups of
+<li>Activate <b>Generate Groups</b> check-box if it is necessary to copy the groups of
elements of the source mesh to the newly created one. </li>
</ul>
</li>
the mass center of the elements, however, you can specify any point as
the <b>Base Point</b> and the elements will be rotated with respect to this
point.<br>
- Note that it is the <b>Base Point</b> whos track exactly equals to the
- path, and all the elements being extruded just keep their relative
- position around the <b>Base Point</b> at each iteration.
+ Note that only the displacement of the <b>Base Point</b> exactly equals to the
+ path, and all other extruded elements simply keep their position relatively to the <b>Base Point</b> at each iteration.
</li>
<li>The elements can also be rotated around the path to get the resulting
mesh in a helical fashion. You can set the values of angles at the
\image html meshexportmesh.png
-At export to MED and SAUV format files additional parameters are available.
+ There are additional parameters available at export to MED and SAUV format files.
<ul>
<li><b>Automatically create groups</b> check-box specifies whether to
create groups of all mesh entities of available dimensions or
not. If checked, the created groups have names like "Group_On_All_Nodes",
- "Group_On_All_Faces" etc.</li>
+ "Group_On_All_Faces", etc.</li>
<li><b>Automatically define space dimension</b> check-box specifies
whether to define space dimension for export by mesh configuration
or not. Usually the mesh is exported as a mesh in 3D space, just as
- it is in Mesh module. The mesh can be exported as a mesh in lower
- dimension in following cases, provided that this check-box is
- checked.
+ it is in Mesh module. The mesh can be exported as a mesh of a lower
+ dimension in the following cases, provided that this check-box is checked:
<ul>
- <li> 1D: if all mesh nodes lie on OX coordinate axis. </li>
- <li> 2D: if all mesh nodes lie on XOY coordinate plane. </li>
+ <li> <b>1D</b>: if all mesh nodes lie on OX coordinate axis. </li>
+ <li> <b>2D</b>: if all mesh nodes lie in XOY coordinate plane. </li>
</ul>
</li>
</ul>
\n \b MESH module of SALOME is destined for:
<ul>
-<li>\ref importing_exporting_meshes_page "import and export of meshes in different formats";</li>
+<li>\ref importing_exporting_meshes_page "import and export of meshes in various formats";</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
\subpage filters_page "Filters" functionality;</li>
<li>\subpage modifying_meshes_page "modifying meshes" with a vast
array of dedicated operations;</li>
-<li>different \subpage measurements_page "measurements" of the mesh objects;
-<li>easily setting parameters via the variables predefined in
-\subpage using_notebook_mesh_page "Salome notebook".</li>
+<li>various \subpage measurements_page "measurements" of the mesh objects.
</ul>
-The possibility to sort the created sub-meshes or groups is detailed on
-\subpage arranging_study_objects_page section.
+It is possible to easily set parameters via the variables predefined in
+\subpage using_notebook_mesh_page "Salome notebook".
Mesh module preferences are described in the \subpage mesh_preferences_page section of SALOME Mesh Help.
+Also, there is a possibility to \subpage arranging_study_objects_page "re-arrange sub-meshes and groups in the SALOME study".
Almost all mesh module functionalities are accessible via
\subpage smeshpy_interface_page "Mesh module Python interface".
Other functions are available in <a class="el" target="_new" href="../../tui/SMESH/docutils/index.html">salome.smesh python package</a>.
-
\image html image7.jpg "Example of MESH module usage for engineering tasks"
*/
other mesh objects - elements, meshes, sub-meshes and groups.
To start <b>Minimum Distance</b> operation, select <b>Minimum Distance</b>
-item from \b Measurements menu.
+tab in \b Measurements dialog.
\image html min_distance.png
-In the dialog box choose the first target and the second target mode by
+Choose the first and the second target by
switching the corresponding radio buttons, then select the objects the distance
between which is to be calculated (or input their IDs directly
-in case of nodes/elements) and press \em Compute button.
+in case of nodes/elements) and press \b Compute button.
-The following types of targets are supported:
-- \em Node: single mesh node;
-- \em Element: single mesh element (not available in this version);
-- \em Object: mesh, sub-mesh or group object (not available in this
+The following targets are supported:
+- \b Node: single mesh node;
+- \b Element: single mesh element (not available in this version);
+- \b Object: mesh, sub-mesh or group object (not available in this
version);
-- \em Origin: origin of the global co-ordinate system.
+- \b Origin: origin of the global co-ordinate system.
-The result will
-be shown in the bottom area of the dialog box. In addition, a simple
+The result will be shown in the bottom area of the dialog. In addition, a simple
preview will be shown in the 3D viewer.
\image html min_distance_preview.png
\section bounding_box_anchor Bounding Box
-This operation allows to calculate the bounding box of the selected
+This operation allows calculating the bounding box of the selected
object(s).
To start <b>Bounding Box</b> operation, select <b>Bounding Box</b>
-item from \b Measurements menu.
+tab in \b Measurements dialog.
\image html bnd_box.png
-In the dialog box choose the required type of the object by switching the
-corresponding radio button, select the object(s) and press \em Compute button.
+Choose the required type of the object by switching the corresponding radio button, select the object(s) and press \em Compute button.
The following types of input are available:
-- \em Objects: select one or several mesh, sub-mesh or group objects;
-- \em Nodes: select a set of mesh nodes;
-- \em Elements: select a set of mesh elements.
+- \b Objects: one or several mesh, sub-mesh or group objects;
+- \b Nodes: a set of mesh nodes;
+- \b Elements: a set of mesh elements.
The result of calculation will be shown in the bottom area of the
-dialog box. In addition, a simple preview will be shown in the 3D
-viewer.
+dialog. In addition, a simple preview will be shown in the 3D viewer.
\image html bnd_box_preview.png
\section basic_properties_anchor Basic Properties
-This operation allows calculation of length, area or volume for the the selected
-object:
-- Length is calculated as a sum of length of all 1D elements;
-- Area id a sum of area of all 2D elements
-- Volume is a sum of volume of all 3D elements.
+This operation provides calculation of length, area or volume for the the selected object:
+- \b Length is calculated as a sum of lengths of all 1D elements;
+- \b Area is a sum of areas of all 2D elements
+- \b Volume is a sum of volumes of all 3D elements.
-To start one of <b>Basic Properties</b> calculations, select <b>Length</b>, <b>Area</b>
-or <b>Volume</b> item from <b>Measurements - Basic Properties</b> menu.
+To start a <b>Basic Properties</b> calculation, select <b>Length</b>, <b>Area</b> or <b>Volume</b> item.
\image html basic_props.png
-In the dialog box select the required type of calculation (length, area or volume), select
-the the object (mesh, sub-mesh or group) and press \em Compute button.
+In the dialog box select the required type of calculation (length, area or volume) and the object (mesh, sub-mesh or group) and press \b Compute button.
-The result of calculation will be shown in the bottom area of the
-dialog box.
+The result of calculation will be shown in the bottom area of the dialog.
\note
-- If mesh consists of 3D elements only, its "length" and "area" will be 0.
-- As calculation result is a sum of length, area and volume of all mesh elements,
- duplications are not taken into account; i.e. all duplicated elements
+- If the mesh consists of 3D elements only, its "length" and "area" will be 0.
+- As calculation result is a sum of lengths, areas and volumes of all mesh elements, the
+ duplication is not taken into account; i.e. all duplicated elements
(elements built on the same set of nodes) will be included into the result.
- Similarly, intersection of elements is not taken into account.
-<b>See Also</b> a sample TUI Script of a
+<b>See Also</b> a sample TUI Script of
\ref tui_measurements_page "Measurement operations".
*/
\anchor mesh_quality_info_anchor
<h2>Quality Information</h2>
-The <b>Quality Info</b> tab page of the dialog box provides overal
-mesh quality controls information on the selected object - mesh,
-sub-mesh or mesh group:
+The <b>Quality Info</b> tab provides overall information about mesh quality controls on the selected object - mesh, sub-mesh or mesh group:
- Name;
- Nodes information:
- - Number of the free nodes;
+ - Number of free nodes;
- Number of double nodes;
- Edges information:
- Number of double edges;
<center>\image html ctrlinfo.png
<em>"Quality Info" page</em></center>
-\note User can set "Double nodes tolerance" in the dialog for local change
+\note It is possible to set "Double nodes tolerance" in the dialog for a local change
or via the "Quality controls" in Mesh preferences.
-\note For the perfomance reason, all quality control values for the big meshes are
-computed only by demand. For this, the user should press the "compute"
-button (see picture). Also, values are automatically computed if the number of the
+\note For performance reasons, all quality control values for big meshes are
+computed only by demand. For this, press the "compute"
+button. Also, values are automatically computed if the number of
nodes / elements does not exceed the "Automatic controls compute limit" set
-via the "Mesh information" preferences (zero value means no limit).
+via the "Mesh information" preferences (zero value means that there is no limit).
The button \b "Dump" allows printing the information displayed in the
dialog box to a .txt file.
In case you get <b>Mesh Information</b> via a TUI script, the information is
displayed in the Python Console.
-<b>See the</b> \ref tui_viewing_mesh_infos "TUI Example".
+
+See the \ref tui_viewing_mesh_infos "TUI Example".
*/
- <b>Automatic Update</b>
- If you toggle <b>Automatic Update</b> checkbox, the model in your
- viewer automatically updated when you make changes in it, depending on
+ viewer will be automatically updated when you make changes in it, depending on
values of additional preferences specified below.
- - <b>Size limit (elements)</b> - allows to specify the maximum
+ - <b>Size limit (elements)</b> - allows specifying the maximum
number of elements in the resulting mesh for which the automatic updating
of the presentation is performed. This option affects only
<b>Compute</b> operation. Zero value means "no limit". Default value
is 500 000 mesh elements.
- <b>Incremental limit check</b> - when this control is switched on,
- check for mesh size limit will be applied not to total number of
- elements in resulting mesh, but iteratively to each entity types
- in the following order: 0D elements, edges, faces, volumes, balls;
- at each step number of entities of given type will be added to the
- total number of elements computed at previous step - if resulting
- number of elements does not exceed size limit, the entities of
- this type will be shown, otherwise user will be warned that some
- entities are not shown.
+ the mesh size limit check is not applied to the total number of
+ elements in the resulting mesh, it is applied iteratively to each entity type
+ in the following order: 0D elements, edges, faces, volumes, balls.
+ At each step the number of entities of a certain type is added to the
+ total number of elements computed at the previous step - if the resulting
+ number of elements does not exceed the size limit, the entities of
+ this type are shown, otherwise the user is warned that some entities are not shown.
- <b>Quality Controls</b>
- If you toggle <b>Display entity</b>, both faces and edges of an
information is shown:
- <b>Simple</b> - as a plain text
- <b>Tree</b> - in a tree-like form
- - <b>Automatic nodes compute limit</b> - allows to define the size limit for the
+ - <b>Automatic nodes compute limit</b> - allows defining the size limit for the
mesh groups for which the number of underlying nodes is calculated
automatically. If the group size exceeds the value set in the preferences,
the user will have to press \em Compute button explicitly. Zero value
means "no limit". By default the value is set to 100 000 mesh elements.
- - <b>Automatic controls compute limit</b> - allows to define the size limit for the
+ - <b>Automatic controls compute limit</b> - allows defining the size limit for the
mesh elements for which the Aspect Ratio histogram is calculated
automatically. If the mesh elements size exceeds the value set in the preferences,
- the user will have to press \em Compute button explicitly. Zero value
+ it is possible to press \b Compute button explicitly to calculate the histogram . Zero value
means "no limit". By default the value is set to 3 000 mesh elements.
- <b>Show details on groups in element information tab</b> - when
this option is switched off (default), only the names of groups, to which the node
or element belongs, are shown in the \ref mesh_element_info_anchor "Info Tab"
tab of "Mesh Information" dialog box. If this option is
switched on, the detailed information on groups is shown.
- - <b>Dump base information</b> - allows to dump base mesh information to the
+ - <b>Dump base information</b> - allows dumping base mesh information to the
file, see \ref mesh_infos_page.
- - <b>Dump element information</b> - allows to dump element information to the
+ - <b>Dump element information</b> - allows dumping element information to the
file, see \ref mesh_infos_page.
- - <b>Dump additional information</b> - allows to dump additional mesh
+ - <b>Dump additional information</b> - allows dumping additional mesh
information to the file, see \ref mesh_infos_page.
- - <b>Dump controls information</b> - allows to dump quality mesh
+ - <b>Dump controls information</b> - allows dumping quality mesh
information to the file, see \ref mesh_infos_page.
- <b>Automatic Parameters</b>
- <b>Ratio Bounding Box Diagonal / Max Size</b> - this parameter is
- used for automatic meshing: ratio between the bounding box of the
+ used for automatic meshing. This is the ratio between the bounding box of the
meshed object and the Max Size of segments.
- - <b>Default Number of Segments</b> - allows defining the default
+ - <b>Default Number of Segments</b> - defines the default
number of segments on each edge.
- <b>Mesh loading</b>
- If <b>No mesh loading from study file at hypothesis modification</b>
- checkbox is on, the mesh data will not be loaded from the study file
+ check-box is on, the mesh data will not be loaded from the study file
when a hypothesis is modified. This allows saving time by omitting
loading data of a large mesh that is planned to be recomputed with other parameters.
</li>
<li>Enter the coordinates of the destination point.</li>
<li>Check in <b>Find closest to destination</b> option or
-select the necessary node manually (X, Y, Z, dX, dY, dZ fields allow
-to see original coordinates and displacement of the node to move).
-\b Preview check-box allows to see the results of the operation.</li>
-<li>The <b>Update Destination</b> button is activated when <b>Find
-closest to destination</b> option is unchecked. Click the <b>Update
-Destination</b> button for update coordinates of the destination point
-from original coordinates of the node to move.</li>
+select the necessary node manually (X, Y, Z, dX, dY, dZ fields show the original coordinates and displacement of the node to move).
+\b Preview check-box shows the operation results.</li>
+<li> <b>Update Destination</b> button is activated when <b>Find closest to destination</b> option is unchecked. Click <b>Update Destination</b> button to update the coordinates of the destination point.</li>
<li>Click the \b Apply or <b>Apply and Close</b> button.</li>
</ol>
the color defined by the <b>Threshold Value</b>.
</li><li>
<b>Elements of a domain</b> allows selection of entities belonging to
-one domain of a mesh. The domain is a part of mesh not connected to
+one domain of a mesh. The domain is mesh part not connected to
other parts. <b>Threshold Value</b> locating any element of the domain can be either
- node ID (that you can pick in the Viewer) or
- geometrical vertex (that you can pick either in the Viewer or in the
