Add a small tutorial.
BIN
doc/html/SMESHTutorial_1/ControlFeature.png
Normal file
After Width: | Height: | Size: 14 KiB |
BIN
doc/html/SMESHTutorial_1/ImportResult.png
Normal file
After Width: | Height: | Size: 12 KiB |
BIN
doc/html/SMESHTutorial_1/MeshInit.png
Normal file
After Width: | Height: | Size: 804 B |
BIN
doc/html/SMESHTutorial_1/MeshResult.png
Normal file
After Width: | Height: | Size: 34 KiB |
BIN
doc/html/SMESHTutorial_1/MeshResult2.png
Normal file
After Width: | Height: | Size: 41 KiB |
BIN
doc/html/SMESHTutorial_1/SMESHOverview.png
Normal file
After Width: | Height: | Size: 40 KiB |
230
doc/html/SMESHTutorial_1/SMESHTutorial_1.html
Normal file
@ -0,0 +1,230 @@
|
||||
<!DOCTYPE HTML PUBLIC "HTML 4.01 Transitional">
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html">
|
||||
<title>Geometry module in SALOME environnement </title>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<h1>SMESH starting tutorial</h1>
|
||||
|
||||
<h2>2D meshing with MEFISTO</h2>
|
||||
|
||||
<h3>Overview</h3>
|
||||
|
||||
<p><i>Before following this tutorial you need to create or import a geometry.
|
||||
Please refere to the GEOM module documentation to do so.</i></p>
|
||||
|
||||
<p>Now we have to load SMESH component. To do so : </p>
|
||||
<ul>
|
||||
<li>click on the SMESH icon or on 'SMESH' into the combo box of resources
|
||||
on botton left.</li>
|
||||
</ul>
|
||||
|
||||
<p><i>SMESH is used to mesh edges, faces and volums each one thanks to a
|
||||
specialised algorithm. To mesh an entity which degree is n, one must have all
|
||||
its lower degree entities meshed. For instance, to mesh a face requires a
|
||||
previous meshing of all its edges. In the example MEFISTO meshes faces, and
|
||||
Regular_1D meshes edges. MEFISTO doesn't check how edges are meshed. The only
|
||||
test it does is to verify that edges are meshed before starting its work.
|
||||
MEFISTO requires an hypothesis : maximum area of triangles. Regular_1D
|
||||
requires one hypothesis among two: number of segments per edge <u>or</u>
|
||||
length of segment.</i> </p>
|
||||
|
||||
<p>The entire operation is done by :</p>
|
||||
<ol>
|
||||
<li>init a mesh object associated to a geometrical object</li>
|
||||
<li>choosing an <u>algorithm</u> for meshing faces, here MEFISTO is
|
||||
choosen</li>
|
||||
<li>choosing an <u>algorithm</u> for meshing edges, here Regular1d is
|
||||
choosen</li>
|
||||
<li>creating <u>hypothesis</u> of calculation. We need to inform :
|
||||
<ul>
|
||||
<li>the number of segments per edge</li>
|
||||
<li>the maximum area per triangle of meshing</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>setting or attaching algorithm and hypothesis to the object loaded</li>
|
||||
<li>launching computation</li>
|
||||
<li>displaying the result in the best mode.</li>
|
||||
</ol>
|
||||
<img alt="" src="SMESHOverview.png">
|
||||
|
||||
<h3>Details</h3>
|
||||
|
||||
<p>Below are explained those 6 steps precisely : </p>
|
||||
<ol>
|
||||
<li><p><u>init a mesh object associated to a geometrical object :</u></p>
|
||||
<p><img src="MeshInit.png"></p>
|
||||
<ul>
|
||||
<li>In the menu bar on the top, find the <u>Mesh</u> menu and click on
|
||||
<u>Init.</u></li>
|
||||
<li>Then in the dialog box select the topology into Geometry field of
|
||||
ObjectBrowser or Viewer, give a name an click on Ok.</li>
|
||||
<li>The topology is now known inside SMESH component.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><p>define algorithms for meshing : </p>
|
||||
<p><img src="SelectAlgorithms.png"></p>
|
||||
<ul>
|
||||
<li>In the menu bar, find <u>Hypothesis</u>, <u>Algorithm</u> then
|
||||
click on <u>Mefisto.</u></li>
|
||||
<li>Do the same to load 'Regular1D'.</li>
|
||||
<li>Remember, Regular1D is needed for edge meshing.</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><p>define <u>hypothesis</u> of calculation :<br>
|
||||
In the menu bar, find <u>Hypothesis</u> then Hypothesis and click on
|
||||
Segments. Then in the dialog box give a name for <u>hypothesis</u> and a
|
||||
value that is the number of segments per edge. Enter 7 segments for
|
||||
example.<br>
|
||||
Do the same for 'Max. Element Area' argument that is the maximum surface
|
||||
of triangles builded during meshing. Enter 2500 here.</p>
|
||||
</li>
|
||||
<li><p>Attach previous arguments (hypothesis) and algorithm to the
|
||||
topology :<br>
|
||||
Select the object in the Object Browser then using pop up menu (right
|
||||
click on object),<br>
|
||||
'Set algorithm' and 'Set Hypothesis' into specialized dialog boxes.<br>
|
||||
You can also find these methods in the menu 'Hypothesis'.</p>
|
||||
</li>
|
||||
<li><p>Selecting the mesh object before, start computation in the pop up
|
||||
menu; click on 'Compute'.</p>
|
||||
</li>
|
||||
<li><p>Update the display using '<i>Update'</i> if necessary.<br>
|
||||
Note : in <i>Preferencies</i> / <i>Mesh</i> menu there is an
|
||||
option to have an automatic update of the display after operations that
|
||||
modify it such as Compute, adding nodes… If this option is not
|
||||
setted user must make an update of the display manually.<br>
|
||||
<br>
|
||||
You may also adjust the display '<i>Properties' / 'Display Mode</i>' has
|
||||
you prefer ; shading, wireframe or shrink,<br>
|
||||
and adjust color and size attributs in a specific dialog box shown
|
||||
below.</p>
|
||||
<p><img src="SetColor.png"></p>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
<h3>Final result of meshing</h3>
|
||||
|
||||
<p>At this final step you can observe the result of 2D meshing of faces by
|
||||
MEFISTO.</p>
|
||||
|
||||
<p>Note : it is possible to change an hypothesis by mean the pop up then
|
||||
<i>Edit</i> and finally compute again.</p>
|
||||
|
||||
<p><img src="MeshResult.png"></p>
|
||||
|
||||
<h2>Meshing with global and local hypothesis</h2>
|
||||
|
||||
<h3>details</h3>
|
||||
|
||||
<p><i>We would now make a mesh as before but with a local modification of
|
||||
parameter (hypothesis) on an edge. We first have to explode the initial
|
||||
topology in GEOMETRY component. This operation will give us access to sub
|
||||
shapes edges of geom.brep.</i></p>
|
||||
<ol>
|
||||
<li><p>import or create a geometry as before</p>
|
||||
</li>
|
||||
<li><p>call 'Explode' method found in 'New Entity' on the menu bar ;
|
||||
(remember the tip about Automatic/Store !) </p>
|
||||
<p><img src="SubShapesSelection.png"></p>
|
||||
</li>
|
||||
<li><p>select the main object, choose 'Edge' in the combo box and click on
|
||||
Ok.<br>
|
||||
<u>Note</u> : do not click on 'select sub shape' at anytime. This
|
||||
function is used with OCC viewer for individual sub shape selection not
|
||||
yet available with VTK.<br>
|
||||
<br>
|
||||
Now the object browser contents all edges as sub shapes of the main
|
||||
topology. Select the first edge <i>Edge_ 1</i> and display only it.
|
||||
Use the pop up 'Display only' mode for this.<br>
|
||||
You may also rename the edge to remember it for future meshing.<br>
|
||||
<i>Our scope : apply a local hypothesis on this edge.<br>
|
||||
</i></p>
|
||||
</li>
|
||||
<li><p>The job is now finished for GEOMETRY component.</p>
|
||||
</li>
|
||||
<li><p>Load SMESH component and use menus 'Mesh' and 'Init' to load the
|
||||
topology into SMESH as before.<br>
|
||||
(Already defined if you have kept the previous study.)</p>
|
||||
</li>
|
||||
<li><p>Define algorithms Regular_1D and Mefisto using menus 'Hypothesis'
|
||||
and 'Algorithm'.</p>
|
||||
</li>
|
||||
<li><p>Define hypothesis 'Segments' = 7 and 'Max. Element Area' = 2500.
|
||||
(Already defined if…) </p>
|
||||
</li>
|
||||
<li><p>Define another hypothesis 'Local length' = 100 to be used only as
|
||||
local parameter for the edge.</p>
|
||||
</li>
|
||||
<li><p>Now we have to attach algorithms and hypothesis to topologies, the
|
||||
global and the sub shape edge.<br>
|
||||
For the main topology, select it and use 'Set algorithms' and 'Set
|
||||
Hypothesis' and attach :<br>
|
||||
hypothesis 'Segments' = 7 and 'Max. Element Area' = 2500.</p>
|
||||
</li>
|
||||
<li><p>To set a local parameter of meshing on the edge we do :<br>
|
||||
click on 'Mesh' menu then 'Add Sub Mesh'. On the dialog box select the
|
||||
main object then sub object edge from Object Browser and GEOMETRY field.
|
||||
Give it a local name; for example <i>myEdge</i> or anyone.</p>
|
||||
<p><img src="SubMeshContruction.png"></p>
|
||||
</li>
|
||||
<li><p>Set the algorithm used for edge meshing. Here use Regular_ 1D.
|
||||
</p>
|
||||
</li>
|
||||
<li><p>Set a local hypothesis to the edge. Use 'Local length' = 100.</p>
|
||||
</li>
|
||||
<li><p>'<i>Compute'</i> (and '<i>Update'</i> display if necessary see
|
||||
before) the main mesh object. This will compute also the edge sub
|
||||
shape.<br>
|
||||
Do not forget to activate the display mode Wireframe,
|
||||
Shading or Shrink; see in pop up menu '<i>Properties'</i>,
|
||||
'<i>Display mode'</i>… </p>
|
||||
</li>
|
||||
<li><p>Move the point of view to watch the edge meshed with a local
|
||||
hypothesis 'Local length' = 100. </p>
|
||||
</li>
|
||||
</ol>
|
||||
|
||||
<h3>The result of second meshing</h3>
|
||||
|
||||
<p>As we see below, the effect produced by setting a local hypothesis setted
|
||||
on the edge <i>Edge_ 1.</i></p>
|
||||
|
||||
<p align="left">Compare to another edge that have the same physical
|
||||
length.</p>
|
||||
|
||||
<p><img src="MeshResult2.png"></p>
|
||||
|
||||
<h2>Using PYTHON interpretor to import an example script</h2>
|
||||
It is easy to import an example of meshing procedure using PYTHON interpretor
|
||||
:
|
||||
<ul>
|
||||
<li>Load SMESH component with VTK viewer.</li>
|
||||
<li>Just type <i>'import geomMesh.py'</i> in the textual window of
|
||||
PYTHON.</li>
|
||||
<li>Validate with the <i>Enter</i> key.</li>
|
||||
<li>You just have to run 'Compute' then choose a display mode to see the
|
||||
result.</li>
|
||||
</ul>
|
||||
This imported example is very similar to the last exercice. It uses a local
|
||||
hypothesis on an edge too.
|
||||
|
||||
<p><img src="ImportResult.png"></p>
|
||||
|
||||
<h2>Control features</h2>
|
||||
|
||||
<p>Test now a control function of area for mesh resulting triangles.</p>
|
||||
|
||||
<p>Find <i>Control</i> on the menu bar then <i>Cells</i> and <i>Area</i>. The
|
||||
image below displays areas with a color depending on its value in the scalar
|
||||
bar shown on the left.<br>
|
||||
Scalar bar general parameters are setted in <i>Preferencies</i> /
|
||||
<i>Mesh</i> / <i>Scalar Bar</i>.</p>
|
||||
|
||||
<p>Specific range parameters are changed with the pop up menu.</p>
|
||||
|
||||
<p><img src="ControlFeature.png"></p>
|
||||
</body>
|
||||
</html>
|
BIN
doc/html/SMESHTutorial_1/SelectAlgorithms.png
Normal file
After Width: | Height: | Size: 1002 B |
BIN
doc/html/SMESHTutorial_1/SetColor.png
Normal file
After Width: | Height: | Size: 3.9 KiB |
BIN
doc/html/SMESHTutorial_1/SubMeshContruction.png
Normal file
After Width: | Height: | Size: 4.2 KiB |
BIN
doc/html/SMESHTutorial_1/SubShapesSelection.png
Normal file
After Width: | Height: | Size: 5.0 KiB |