Salome HOME
Update of GUI documentation for bugs:
[modules/smesh.git] / doc / salome / gui / SMESH / files / constructing_meshes.htm
index e4a680d66ace919e32e62918cc8cc20e7e26e6b3..0995c01c21a7d41e6d8aedf657d6e28a66fb169a 100755 (executable)
@@ -2,31 +2,11 @@
 \r
 <html>\r
 \r
-<!--(==============================================================)-->\r
-<!--(Document created with RoboEditor. )============================-->\r
-<!--(==============================================================)-->\r
-\r
 <head>\r
-\r
 <title>Constructing meshes</title>\r
-\r
-<!--(Meta)==========================================================-->\r
-\r
-<meta http-equiv=content-type content="text/html; charset=windows-1252">\r
-<meta name=generator content="RoboHELP by eHelp Corporation - www.ehelp.com">\r
-<meta name=generator-major-version content=0.1>\r
-<meta name=generator-minor-version content=1>\r
-<meta name=filetype content=kadov>\r
-<meta name=filetype-version content=1>\r
-<meta name=page-count content=1>\r
-<meta name=layout-height content=966>\r
-<meta name=layout-width content=740>\r
-\r
-\r
-<!--(Links)=========================================================-->\r
-\r
- <link rel='stylesheet' href='../default_ns.css'>\r
-<script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">\r
+<meta http-equiv="content-type" content="text/html; charset=windows-1252">\r
+<meta name="generator" content="RoboHelp by eHelp Corporation www.ehelp.com">\r
+<link rel="stylesheet" href="../default_ns.css"><script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">\r
 <!--\r
 if (navigator.appName !="Netscape")\r
 {   document.write("<link rel='stylesheet' href='../default.css'>");}\r
@@ -34,21 +14,37 @@ if (navigator.appName !="Netscape")
 </script>\r
 <style type="text/css">\r
 <!--\r
-p.whs1 {margin-left: 0px;}\r
-ul.whs2 {list-style: disc;}\r
-p.whs3 {margin-left: 40px;}\r
-img_whs4 {border-style: none; border: none; width: 22px; height: 24px;}\r
-p.whs5 {margin-left: 80px;}\r
-img_whs6 {border-style: none; border: none; width: 304px; height: 305px;}\r
-img_whs7 {border-style: none; border: none; width: 268px; height: 161px;}\r
+p.whs1 { margin-left:0px; }\r
+ul.whs2 { list-style:disc; }\r
+p.whs3 { margin-left:40px; }\r
+img_whs4 { border:none; width:22px; height:24px; border-style:none; }\r
+p.whs5 { margin-left:80px; }\r
+img_whs6 { border:none; width:370px; height:296px; float:none; border-style:none; }\r
+img_whs7 { border:none; width:173px; height:88px; border-style:none; }\r
+img_whs8 { border:none; width:34px; height:29px; border-style:none; }\r
+img_whs9 { border:none; width:29px; height:28px; border-style:none; }\r
+img_whs10 { border:none; width:30px; height:29px; border-style:none; }\r
+img_whs11 { border:none; width:232px; height:142px; border-style:none; float:right; }\r
+img_whs12 { border:none; width:25px; height:24px; border-style:none; }\r
+img_whs13 { border:none; width:457px; height:486px; float:none; border-style:none; }\r
+img_whs14 { border:none; width:564px; height:402px; float:none; border-style:none; }\r
+img_whs15 { border:none; width:260px; height:270px; float:none; border-style:none; }\r
+table.whs16 { x-cell-content-align:top; border-spacing:0px; width:67.18%; }\r
+col.whs17 { width:65.545%; }\r
+col.whs18 { width:34.455%; }\r
+tr.whs19 { x-cell-content-align:top; }\r
+td.whs20 { padding-right:10px; padding-left:10px; border-right-style:none; border-left-style:none; border-top-style:none; border-bottom-style:none; }\r
+p.whs21 { margin-left:24px; }\r
+td.whs22 { padding-right:10px; padding-left:10px; border-top-style:none; border-bottom-style:none; border-right-style:none; }\r
+img_whs23 { border:none; width:214px; height:240px; }\r
+p.whs24 { margin-left:40px; font-weight:bold; }\r
 -->\r
-</style>\r
-<script type="text/javascript" language="JavaScript">\r
+</style><script type="text/javascript" language="JavaScript">\r
 <!--\r
 if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))\r
 {\r
   var strNSS = "<style type='text/css'>";\r
-  strNSS += "p.whs1 {margin-left:1; }";\r
+  strNSS += "p.whs1 {margin-left:1pt; }";\r
   strNSS +="</style>";\r
   document.write(strNSS);\r
 }\r
@@ -70,48 +66,47 @@ onerror = null;
 </script>\r
 <style type="text/css">\r
 <!--\r
-  div.WebHelpPopupMenu {position:absolute; left:0px; top:0px; z-index:4; visibility:hidden;}\r
+div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }\r
+p.WebHelpNavBar { text-align:right; }\r
 -->\r
-</style>\r
-<script type="text/javascript" language="javascript1.2" src="../whmsg.js"></script>\r
+</style><script type="text/javascript" language="javascript1.2" src="../whmsg.js"></script>\r
 <script type="text/javascript" language="javascript" src="../whver.js"></script>\r
 <script type="text/javascript" language="javascript1.2" src="../whproxy.js"></script>\r
 <script type="text/javascript" language="javascript1.2" src="../whutils.js"></script>\r
 <script type="text/javascript" language="javascript1.2" src="../whtopic.js"></script>\r
-</head>\r
-\r
-<!--(Body)==========================================================-->\r
-\r
-\r
-<body>\r
-\r
 <script type="text/javascript" language="javascript1.2">\r
 <!--\r
 if (window.gbWhTopic)\r
 {\r
-       if (window.addTocInfo)\r
+       if (window.setRelStartPage)\r
        {\r
-       addTocInfo("SMESH module\nCreating meshes\nConstructing meshes");\r
-addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");\r
+       addTocInfo("MESH module\nCreating meshes\nConstructing meshes");\r
+addButton("show",BTN_IMG,"Show","","","","",0,0,"../whd_show0.gif","../whd_show2.gif","../whd_show1.gif");\r
+addButton("hide",BTN_IMG,"Hide","","","","",0,0,"../whd_hide0.gif","../whd_hide2.gif","../whd_hide1.gif");\r
 \r
        }\r
-       if (window.writeBtnStyle)\r
-               writeBtnStyle();\r
 \r
-       if (window.writeIntopicBar)\r
-               writeIntopicBar(1);\r
 \r
        if (window.setRelStartPage)\r
        {\r
-       setRelStartPage("../smesh.htm");\r
+       setRelStartPage("../index.htm");\r
 \r
-               autoSync(0);\r
+               autoSync(1);\r
                sendSyncInfo();\r
                sendAveInfoOut();\r
        }\r
+\r
 }\r
 else\r
-       document.location.reload();\r
+       if (window.gbIE4)\r
+               document.location.reload();\r
+//-->\r
+</script>\r
+</head>\r
+<body><script type="text/javascript" language="javascript1.2">\r
+<!--\r
+if (window.writeIntopicBar)\r
+       writeIntopicBar(4);\r
 //-->\r
 </script>\r
 <h1>Constructing meshes</h1>\r
@@ -125,40 +120,54 @@ else
        <li class=kadov-p><p class="whs1">Selecting a geometrical \r
  object for meshing</p></li>\r
        \r
-       <li class=kadov-p><p class="whs1">Applying one or several \r
- previously <a href="about_hypotheses.htm">hypotheses</a> and <a href="about_meshing_algorithms.htm">meshing \r
algorithms</a> which will be used at computation of this mesh.</p></li>\r
+       <li class=kadov-p><p class="whs1">Applying <a href="about_meshing_algorithms.htm">meshing \r
+ algorithms</a> and <a href="about_hypotheses.htm">hypotheses</a> which \r
+ will be used at computation of this mesh.</p></li>\r
 </ul>\r
 \r
 <p class="whs1">&nbsp;</p>\r
 \r
 <p class=TODO>To construct a mesh:</p>\r
 \r
-<p class=TODO>&nbsp;</p>\r
-\r
-<p class="whs3">In the <span style="font-weight: bold;"><B>Mesh \r
- </B></span>menu select<span style="font-weight: bold;"><B> Global Hyp. </B></span>or \r
+<p class="whs3">1. In the <span style="font-weight: bold;"><B>Mesh \r
+ </B></span>menu select<span style="font-weight: bold;"><B> Create Mesh </B></span>or \r
  click <img src="../image32.gif" width="22px" height="24px" border="0" class="img_whs4"> button in the toolbar. The following dialog box will \r
  appear:</p>\r
 \r
 <p class="whs3">&nbsp;</p>\r
 \r
-<p class="whs5"><img src="../image31.gif" width="304px" height="305px" border="0" class="img_whs6"></p>\r
+<p class="whs5"><img src="../pics/createmesh-inv.png" x-maintain-ratio="TRUE" width="370px" height="296px" border="0" class="img_whs6"></p>\r
 \r
 <p class="whs5">&nbsp;</p>\r
 \r
-<p class="whs3">In the Object Browser the structure of the \r
new mesh will be displayed as follows:</p>\r
+<p class="whs3">2. For example, you need to mesh a 3d object. \r
+ </p>\r
 \r
-<p class="whs3">&nbsp;</p>\r
+<p class="whs3">First, type the name for your mesh in the \r
+ &quot;Name&quot; box, by default, it is &quot;Mesh_1&quot;. Then select \r
+ the object you wish to mesh in the Object Browser <img src="../image119.gif" width="173px" height="88px" border="0" class="img_whs7">and click \r
+ the <img src="../image120.gif" width="34px" height="29px" border="0" class="img_whs8"> &quot;Add&quot; button. </p>\r
 \r
-<p class="whs3"><img src="../image44.jpg" width="268px" height="161px" border="0" class="img_whs7"></p>\r
+<p class="whs3">Now you can define 1d Algorithm and 1d Hypotheses, \r
+ which will be applied to the edges of your object. (Note that any object \r
+ has edges, even if their existence is not apparent, for example, a sphere \r
+ has 4 edges). Click the &nbsp;<img src="../image121.gif" width="29px" height="28px" border="0" class="img_whs9"> button to add a hypothesis. Click the <img src="../image122.gif" width="30px" height="29px" border="0" class="img_whs10"> button \r
+ to define values for the current hypothesis. The use of additional hypotheses \r
+ is optional (i.e. you may leave &quot;None&quot; in this box). &nbsp;&nbsp;</p>\r
 \r
 <p class="whs3">&nbsp;</p>\r
 \r
-<p class="whs3">It contains:</p>\r
+<p class="whs3">Proceed in the same way with 2d and 3d Algorithms \r
+ and Hypotheses, note that the choice of hypotheses depends on the algorithm. \r
+ There must be one Algorithm and one or several Hypotheses for each dimension \r
+ of your object, otherwise you will not get any mesh at all. Of course, \r
+ if you wish to mesh a face, which is a 2d object, you don't need to define \r
+ 3d Algorithm and Hypotheses. </p>\r
 \r
-<p class="whs3">&nbsp;</p>\r
+<p class="whs3">In the <span style="font-weight: bold;"><B>Object \r
+ Browser</B></span> the structure of the new mesh will be displayed as follows:</p>\r
+\r
+<p class="whs3"><img src="../image88.jpg" width="232px" height="142px" align="right" border="0" class="img_whs11">It contains:</p>\r
 \r
 <ul type="disc" class="whs2">\r
        \r
@@ -174,6 +183,86 @@ else
  to the construction of the mesh.</p></li>\r
 </ul>\r
 \r
+<p class="whs3">&nbsp;</p>\r
+\r
+<p class="whs3">There is an alternative way to create a mesh \r
+ on an object simply by clicking <span style="font-weight: bold;"><B>Assign \r
+ a set of hypotheses </B></span>button and selecting between Automatic Tetrahedralization \r
+ or Hexahedralization. &nbsp;The \r
+ program will automatically generate a 3D mesh with the most appropriate \r
+ settings. In the same way you can apply this functionality for meshing \r
+ 2D objects, in which case 3D algorithms are not applied. </p>\r
+\r
+<p class="whs3">&nbsp;</p>\r
+\r
+<p class="whs3">3. Now, when everything is ready, select \r
+ your mesh in the <span style="font-weight: bold;"><B>Object Browser</B></span>. \r
+ &nbsp;From the \r
+ <span style="font-weight: bold;"><B>Mesh </B></span>menu select<span style="font-weight: bold;"><B> \r
+ Compute </B></span>or click <img src="../image28.gif" width="25px" height="24px" border="0" class="img_whs12"> button of the toolbar. The Mesh \r
+ Computation information box appears.</p>\r
+\r
+<p class="whs3">&nbsp;</p>\r
+\r
+<p class="whs3"><img src="../pics/meshcomputationsucceed.png" x-maintain-ratio="TRUE" width="457px" height="486px" border="0" class="img_whs13"></p>\r
+\r
+<p class="whs3">&nbsp;</p>\r
+\r
+<p class="whs3">If the mesh computation failed, the information \r
+ about the cause of the failure is provided. </p>\r
+\r
+<p class="whs3">&nbsp;</p>\r
+\r
+<p class="whs3"><img src="../pics/meshcomputationfail.png" x-maintain-ratio="TRUE" width="564px" height="402px" border="0" class="img_whs14"> </p>\r
+\r
+<p class="whs3">&nbsp;</p>\r
+\r
+<p class="whs3">After you select the error, <span style="font-weight: bold;"><B>Show \r
+ Subshape</B></span> button allows visualizing the mesh elements that cause \r
+ it</p>\r
+\r
+<p class="whs3">&nbsp;</p>\r
+\r
+<p class="whs3"><img src="../pics/failed_computation.png" x-maintain-ratio="TRUE" width="260px" height="270px" border="0" class="img_whs15"> </p>\r
+\r
+<p class="whs3">&nbsp;</p>\r
+\r
+<p class="whs3"><span style="font-weight: bold;"><B>Publish \r
+ Subshape</B></span> button allows importing it in a separate MED or UNV file. \r
+ </p>\r
+\r
+<p class="whs3">&nbsp;</p>\r
+\r
+<table x-use-null-cells width="67.18%" cellspacing="0" class="whs16">\r
+<col class="whs17">\r
+<col class="whs18">\r
+\r
+<tr valign="top" class="whs19">\r
+<td width="65.545%" class="whs20">\r
+<p class="whs21"><span style="font-weight: bold;"><B>Note:</B></span> \r
+ It is possible to define a 1D or a 2D mesh in a python script and then \r
+ use such submeshes in the construction of a 3D mesh. For this, there exist \r
+ two algorithms: <span style="font-weight: bold;"><B>Use existing edges</B></span> \r
+ and <span style="font-weight: bold;"><B>Use existing faces</B></span>. They are \r
+ not entirely usable from the GUI, so a mesh created using these algorithms \r
+ should be exported into a python script, edited and then imported into \r
+ the GUI. </td>\r
+<td width="34.455%" class="whs22">\r
+<p><img src="../image162.gif" width="214px" height="240px" border="0" class="img_whs23"></td></tr>\r
+</table>\r
+\r
+<p class="whs24">&nbsp;</p>\r
+\r
+<p class="whs3">&nbsp;</p>\r
+\r
+<p class="whs3">Consider trying a sample script for construction \r
+ of a mesh from our <a href="../constructing_meshes.htm">TUI Scripts</a> \r
+ section.</p>\r
+\r
+<p class="whs3">&nbsp;</p>\r
+\r
+<p>&nbsp;</p>\r
+\r
 <script type="text/javascript" language="javascript1.2">\r
 <!--\r
 if (window.writeIntopicBar)\r
@@ -181,5 +270,4 @@ if (window.writeIntopicBar)
 //-->\r
 </script>\r
 </body>\r
-\r
 </html>\r