From bcb016c5f87802c0275f8598e81cde41b132dd40 Mon Sep 17 00:00:00 2001 From: maintenance team Date: Fri, 30 Nov 2007 16:13:03 +0000 Subject: [PATCH] Update of GUI documentation for bugs: 16202, 16203, 16617, 16842, 17694 --- doc/salome/gui/SMESH/about_viewing_meshes.htm | 24 +- doc/salome/gui/SMESH/extrusion.htm | 36 +- .../gui/SMESH/extrusion_along_a_path.htm | 763 +++++++++--------- .../gui/SMESH/files/constructing_meshes.htm | 31 + doc/salome/gui/SMESH/files/rotation.htm | 35 +- doc/salome/gui/SMESH/files/symmetry.htm | 40 +- doc/salome/gui/SMESH/files/translation.htm | 32 +- .../gui/SMESH/files/viewing_mesh_info.htm | 87 +- doc/salome/gui/SMESH/image162.gif | Bin 0 -> 4350 bytes doc/salome/gui/SMESH/pics/dialogmesh.png | Bin 0 -> 12043 bytes doc/salome/gui/SMESH/pics/eleminfo1.png | Bin 0 -> 13974 bytes doc/salome/gui/SMESH/pics/eleminfo2.png | Bin 0 -> 15912 bytes doc/salome/gui/SMESH/pics/extrusion1.png | Bin 22957 -> 23402 bytes doc/salome/gui/SMESH/pics/extrusion2.png | Bin 0 -> 23481 bytes .../gui/SMESH/pics/extrusionalongaline1.png | Bin 14660 -> 16882 bytes .../gui/SMESH/pics/extrusionalongaline2.png | Bin 14738 -> 16961 bytes doc/salome/gui/SMESH/pics/revolution1.png | Bin 19193 -> 21841 bytes doc/salome/gui/SMESH/pics/revolution2.png | Bin 19287 -> 21912 bytes doc/salome/gui/SMESH/pics/rotation.png | Bin 17556 -> 23022 bytes doc/salome/gui/SMESH/pics/symmetry1.png | Bin 14413 -> 19741 bytes doc/salome/gui/SMESH/pics/symmetry2.png | Bin 16135 -> 21831 bytes doc/salome/gui/SMESH/pics/symmetry3.png | Bin 15988 -> 21797 bytes doc/salome/gui/SMESH/pics/translation1.png | Bin 15379 -> 20689 bytes doc/salome/gui/SMESH/pics/translation2.png | Bin 14150 -> 19462 bytes .../gui/SMESH/projection_algorithms.htm | 35 +- doc/salome/gui/SMESH/revolution.htm | 55 +- 26 files changed, 623 insertions(+), 515 deletions(-) create mode 100755 doc/salome/gui/SMESH/image162.gif create mode 100755 doc/salome/gui/SMESH/pics/dialogmesh.png create mode 100755 doc/salome/gui/SMESH/pics/eleminfo1.png create mode 100755 doc/salome/gui/SMESH/pics/eleminfo2.png create mode 100755 doc/salome/gui/SMESH/pics/extrusion2.png diff --git a/doc/salome/gui/SMESH/about_viewing_meshes.htm b/doc/salome/gui/SMESH/about_viewing_meshes.htm index 432af19e6..5c3d955a8 100755 --- a/doc/salome/gui/SMESH/about_viewing_meshes.htm +++ b/doc/salome/gui/SMESH/about_viewing_meshes.htm @@ -17,7 +17,7 @@ if (navigator.appName !="Netscape") img_whs1 { border:none; width:25px; height:24px; border-style:none; } p.whs2 { font-weight:normal; } p.whs3 { margin-left:40px; } -img_whs4 { border:none; width:404px; height:413px; border-style:none; } +img_whs4 { border:none; width:169px; height:386px; float:none; border-style:none; } ul.whs5 { list-style:disc; } p.whs6 { font-weight:bold; } --> @@ -100,15 +100,15 @@ if (window.writeIntopicBar) information about it, change its presentation parameters and access to other useful options by right-clicking on the selected mesh.

Erase all +
Hide all - allows to hide all objects in the viewer

provides basic information about the mesh.

Mesh + Element Info - provides basic information about the selected element + of the mesh.
Numbering - allows to display the ID numbers of all meshing elements or nodes composing your @@ -145,13 +149,13 @@ if (window.writeIntopicBar)
Clipping - allows to create cross-sections of the selected objects.
Quality Controls - - graphically presents various information about meshes.
Controls - graphically + presents various information about meshes.
Erase - - allows to hide the selected mesh from the viewer.
Hide - + allows to hide the selected mesh from the viewer.
Display Only +
Show Only -allows to display only the selected mesh, hiding all other from the viewer.

Dump view diff --git a/doc/salome/gui/SMESH/extrusion.htm b/doc/salome/gui/SMESH/extrusion.htm index 7b56ecd85..5974a8d2b 100755 --- a/doc/salome/gui/SMESH/extrusion.htm +++ b/doc/salome/gui/SMESH/extrusion.htm @@ -14,9 +14,9 @@ if (navigator.appName !="Netscape") - - - - - - - - - -

Extrusion along a path

- -

In principle, Extrusion along a path - works in the same way as Extrusion, - the main difference is that we define not a vector, but a path of extrusion - which must be a meshed edge. To get an idea of how this algorithm works, - examine several examples, starting from the most simple case of extrusion - along a straight edge. In all examples the same mesh will be extruded - along different paths and with different parameters. This sample 2D mesh - has two quadrangle faces and seven edges. Look at the picture, where white - digits are the node numbers and green are the element numbers:

- -

Extrusion along - a straight edge (not using base point or angles)

- - --- - - - -

- -

The left image shows a 1D path mesh, built - on a linear edge, and the initial 2D mesh. The right image shows the result - of extrusion of two edges (#1 and #2) of the initial mesh along the path. - Node #1 of path mesh has been selected as Start - node.

- -

Extrusion along - a curvilinear edge (with and without angles)

- - ---- - - - - - - - - - -

-	-	-
- The left image shows a 1D path mesh, built on curvilinear edge, and - the initial 2D - mesh.	- The central image shows the result of extrusion of one edge (#2) of - the initial mesh along the path. Node - #1 of path mesh has been selected as Start - node.	- The same, but using angles {45, 45, 45, 0, -45, -45, -45}

- -

Extrusion - along a sub-mesh.

- - --- - - - -

- -

In this example the path mesh has been built - on a wire (polyline with six edges). The first edge of the wire was used - as Shape (edge), node #1 as Start node. The angles have been defined - as {10, 10, 10}. The middle edge (#4) of the initial mesh has been extruded.

- -

Extrusion - of 2d elements along a sub-mesh.

- - --- - - - -

- -

This extrusion bases on the same path mesh - as in the previous example but the third edge of the wire was set as Shape (edge) and node #4 as Start - node. Please note, that the extrusion has been done in direction - from node #4 to node #3, i.e. against the wire direction. In this example - both faces of the initial mesh have been extruded.

- -

Extrusion of 2d elements - along a closed path.

- - ---- - - - - - - - - - -

-	-	-
- The left image shows a path mesh built on a closed edge (circle).	- The central image shows the result of extrusion of both faces of the - initial mesh. Note, that no sewing has been done, so, there are six coincident - nodes and two coincident faces in the resulting mesh.	- The same, but using angles {45, -45, 45, -45, 45, -45, 45, -45}

- -

To use Extrusion along a path:

- -

1. From the Modification - menu choose the Extrusion along - a path item or click button in the toolbar. The - following dialog box will appear:

- -

2. In the dialog box you should

- -

select the type of - elements which will be extruded (1D or 2D),
specify the IDs - of the elements which will be extruded by selecting them in the - 3D viewer or Select the whole mesh, submesh - or group,
define the Path - along which the elements will be extruded,

- -

Path definition consists of several elements -

- -

Mesh - - containing a 1D sub-mesh on the edge, - along which proceeds the extrusion.
Shape - (edge) - as the mesh can be complex, - the edge is used to define the sub-mesh for the path.
Start - node - the - first or the last node on the edge. It is used to define the direction - of extrusion.

- -

3. There are two optional parameters, which - can be very useful.

- -

If the path of extrusion - is curvilinear, at each iteration the extruded shape is rotated to keep - its initial angularity to the curve. By default, the Base - Point around which the shape is rotated is the mass center of the - shape, however, you can specify any point as the Base - Point and the shape will be rotated with respect to this point.
The shape 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 right, add them to the list of - angles at the left by pressing the button and remove them - from the list by pressing the button.

- -

4. Click the Apply - or OK button. Mesh edges - will be extruded into faces, faces into volumes. The external surface - of the resulting 3d mesh (if faces have been extruded) is covered with - faces, and corners with edges. If the path is closed, the resulting mesh - can contain duplicated nodes and faces, because no sewing is done.

- -

See - Also a sample TUI Script of an Extrusion - along a Path operation.

- -

- - - - + + + + + +Extrusion along a path + + + + + + + + + + + + + +

Extrusion along a path

+ +

In principle, Extrusion along a path + works in the same way as Extrusion, + the main difference is that we define not a vector, but a path of extrusion + which must be a meshed edge. To get an idea of how this algorithm works, + examine several examples, starting from the most simple case of extrusion + along a straight edge. In all examples the same mesh will be extruded + along different paths and with different parameters. This sample 2D mesh + has two quadrangle faces and seven edges. Look at the picture, where white + digits are the node numbers and green are the element numbers:

+ +

Extrusion along + a straight edge (not using base point or angles)

+ + +++ + + + +

+ +

The left image shows a 1D path mesh, built + on a linear edge, and the initial 2D mesh. The right image shows the result + of extrusion of two edges (#1 and #2) of the initial mesh along the path. + Node #1 of path mesh has been selected as Start + node.

+ +

Extrusion along + a curvilinear edge (with and without angles)

+ + ++++ + + + + + + + + + +

+	+	+
+ The left image shows a 1D path mesh, built on curvilinear edge, and + the initial 2D + mesh.	+ The central image shows the result of extrusion of one edge (#2) of + the initial mesh along the path. Node + #1 of path mesh has been selected as Start + node.	+ The same, but using angles {45, 45, 45, 0, -45, -45, -45}

+ +

Extrusion + along a sub-mesh.

+ + +++ + + + +

+ +

In this example the path mesh has been built + on a wire (polyline with six edges). The first edge of the wire was used + as Shape (edge), node #1 as Start node. The angles have been defined + as {10, 10, 10}. The middle edge (#4) of the initial mesh has been extruded.

+ +

Extrusion + of 2d elements along a sub-mesh.

+ + +++ + + + +

+ +

This extrusion bases on the same path mesh + as in the previous example but the third edge of the wire was set as Shape (edge) and node #4 as Start + node. Please note, that the extrusion has been done in direction + from node #4 to node #3, i.e. against the wire direction. In this example + both faces of the initial mesh have been extruded.

+ +

Extrusion of 2d elements + along a closed path.

+ + ++++ + + + + + + + + + +

+	+	+
+ The left image shows a path mesh built on a closed edge (circle).	+ The central image shows the result of extrusion of both faces of the + initial mesh. Note, that no sewing has been done, so, there are six coincident + nodes and two coincident faces in the resulting mesh.	+ The same, but using angles {45, -45, 45, -45, 45, -45, 45, -45}

+ +

To use Extrusion along a path:

+ +

1. From the Modification + menu choose the Extrusion along + a path item or click button in the toolbar. The + following dialog box will appear:

+ +

2. In the dialog box you should

+ +

select the type of + elements which will be extruded (1D or 2D),
specify the IDs + of the elements which will be extruded by selecting them in the + 3D viewer or Select the whole mesh, submesh + or group,
define the Path + along which the elements will be extruded,

+ +

Path definition consists of several elements +

+ +

Mesh + - containing a 1D sub-mesh on the edge, + along which proceeds the extrusion.
Shape + (edge) - as the mesh can be complex, + the edge is used to define the sub-mesh for the path.
Start + node - the + first or the last node on the edge. It is used to define the direction + of extrusion.

+ +

3. There are two optional parameters, which + can be very useful.

+ +

If the path of extrusion + is curvilinear, at each iteration the extruded shape is rotated to keep + its initial angularity to the curve. By default, the Base + Point around which the shape is rotated is the mass center of the + shape, however, you can specify any point as the Base + Point and the shape will be rotated with respect to this point.
The shape 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 right, add them to the list of + angles at the left by pressing the button and remove them + from the list by pressing the button.

+ +

Generate + Groups checkbox allows copying the groups of elements of the source + mesh to the newly created one.

+ +

4. Click the Apply + or OK button. Mesh edges + will be extruded into faces, faces into volumes. The external surface + of the resulting 3d mesh (if faces have been extruded) is covered with + faces, and corners with edges. If the path is closed, the resulting mesh + can contain duplicated nodes and faces, because no sewing is done.

+ +

See + Also a sample TUI Script of an Extrusion + along a Path operation.

+ +

+ + + + diff --git a/doc/salome/gui/SMESH/files/constructing_meshes.htm b/doc/salome/gui/SMESH/files/constructing_meshes.htm index ea2cf4bac..0995c01c2 100755 --- a/doc/salome/gui/SMESH/files/constructing_meshes.htm +++ b/doc/salome/gui/SMESH/files/constructing_meshes.htm @@ -29,6 +29,15 @@ img_whs12 { border:none; width:25px; height:24px; border-style:none; } img_whs13 { border:none; width:457px; height:486px; float:none; border-style:none; } img_whs14 { border:none; width:564px; height:402px; float:none; border-style:none; } img_whs15 { border:none; width:260px; height:270px; float:none; border-style:none; } +table.whs16 { x-cell-content-align:top; border-spacing:0px; width:67.18%; } +col.whs17 { width:65.545%; } +col.whs18 { width:34.455%; } +tr.whs19 { x-cell-content-align:top; } +td.whs20 { padding-right:10px; padding-left:10px; border-right-style:none; border-left-style:none; border-top-style:none; border-bottom-style:none; } +p.whs21 { margin-left:24px; } +td.whs22 { padding-right:10px; padding-left:10px; border-top-style:none; border-bottom-style:none; border-right-style:none; } +img_whs23 { border:none; width:214px; height:240px; } +p.whs24 { margin-left:40px; font-weight:bold; } -->

Mesh infos

There are two types of information boxes: Standard - Mesh Infos and Advanced - Mesh Infos.

- -

Standard
Advanced

- -

There are three information boxes: Standard + Mesh Infos, Advanced Mesh Infos + and Mesh Element Info.

Standard Mesh Infos

The Standard +

The Standard Mesh Infos box gives only the information on the number of elements of maximum dimension and the number of nodes in the mesh. However, from this Info you can learn about groups selected on this mesh.

-
To view the Standard +
To view the Standard Mesh Infos, select your mesh or submesh in the Object Browser and select Standard Mesh Infos from the Mesh menu or click - button in the toolbar. The following information will + button in the toolbar. The following information will be displayed:
-

+

-
+

Advanced Mesh Infos

The Advanced Mesh - Infos gives more information about the mesh, including the total - number of faces and volumes and their geometrical types.
+ Infos box gives more information + about the mesh, including the total number of faces and volumes and their + geometrical types.

To view the Advanced Mesh Infos, select your mesh or submesh in the Object Browser and select Advanced Mesh Infos from the Mesh menu or click button + style="font-weight: bold;">Mesh menu or click button in the toolbar. The following information will be displayed:

-
+
-

+

-

+

-
In case you get Mesh Infos via a TUI +
In case you get Mesh Infos via a TUI script, the information is displayed in Python Console.
-

+

-
+
-

+

-

+
Mesh Element Infos
-

+
The Mesh Element Infos box gives + basic information about the type and the coordinates of the selected mesh + element.
+ +

-

+

-

+

-
Revolution
+
Revolution

Revolution is a type of surface meshing by generation from discretized lines. It is used to build mesh elements of plus one dimension than the @@ -92,51 +93,55 @@ if (window.writeIntopicBar)

-
1. From the Modification +
1. From the Modification menu choose the Revolution item - or click button in the toolbar. The following dialog box + or click button in the toolbar. The following dialog box shall appear:
-

+

-
+
-

+

-
+
-

+

-
2. In this dialog box you should specify:
+
2. In this dialog box you should specify:
-
+
-
the type of elements +
the type of elements which will be extruded (1D or 2D),
-
specify the IDs of +
specify the IDs of the elements which will be revolved by selecting them in the 3D viewer or select the whole mesh or submesh,
-
specify the axis (point +
specify the axis (point and vector) around which the elements will be revolved,
-
angle of rotation,
+
angle of rotation,
-
number of steps,
+
number of steps,
-
tolerance of rotation
+
tolerance of rotation

-

+
Generate + Groups checkbox allows copying the groups of elements of the source + mesh to the newly created one.
-
3. Click the Apply +

+ +
3. Click the Apply or OK button.
-

+

+ style="margin-left: 40px;">

-- 2.39.2