Salome HOME
Update of GUI documentation for bugs:
[modules/smesh.git] / doc / salome / gui / SMESH / files / constructing_meshes.htm
1 <!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">\r
2 \r
3 <html>\r
4 \r
5 <head>\r
6 <title>Constructing meshes</title>\r
7 <meta http-equiv="content-type" content="text/html; charset=windows-1252">\r
8 <meta name="generator" content="RoboHelp by eHelp Corporation www.ehelp.com">\r
9 <link rel="stylesheet" href="../default_ns.css"><script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">\r
10 <!--\r
11 if (navigator.appName !="Netscape")\r
12 {   document.write("<link rel='stylesheet' href='../default.css'>");}\r
13 //-->\r
14 </script>\r
15 <style type="text/css">\r
16 <!--\r
17 p.whs1 { margin-left:0px; }\r
18 ul.whs2 { list-style:disc; }\r
19 p.whs3 { margin-left:40px; }\r
20 img_whs4 { border:none; width:22px; height:24px; border-style:none; }\r
21 p.whs5 { margin-left:80px; }\r
22 img_whs6 { border:none; width:370px; height:296px; float:none; border-style:none; }\r
23 img_whs7 { border:none; width:173px; height:88px; border-style:none; }\r
24 img_whs8 { border:none; width:34px; height:29px; border-style:none; }\r
25 img_whs9 { border:none; width:29px; height:28px; border-style:none; }\r
26 img_whs10 { border:none; width:30px; height:29px; border-style:none; }\r
27 img_whs11 { border:none; width:232px; height:142px; border-style:none; float:right; }\r
28 img_whs12 { border:none; width:25px; height:24px; border-style:none; }\r
29 img_whs13 { border:none; width:457px; height:486px; float:none; border-style:none; }\r
30 img_whs14 { border:none; width:564px; height:402px; float:none; border-style:none; }\r
31 img_whs15 { border:none; width:260px; height:270px; float:none; border-style:none; }\r
32 table.whs16 { x-cell-content-align:top; border-spacing:0px; width:67.18%; }\r
33 col.whs17 { width:65.545%; }\r
34 col.whs18 { width:34.455%; }\r
35 tr.whs19 { x-cell-content-align:top; }\r
36 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
37 p.whs21 { margin-left:24px; }\r
38 td.whs22 { padding-right:10px; padding-left:10px; border-top-style:none; border-bottom-style:none; border-right-style:none; }\r
39 img_whs23 { border:none; width:214px; height:240px; }\r
40 p.whs24 { margin-left:40px; font-weight:bold; }\r
41 -->\r
42 </style><script type="text/javascript" language="JavaScript">\r
43 <!--\r
44 if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))\r
45 {\r
46   var strNSS = "<style type='text/css'>";\r
47   strNSS += "p.whs1 {margin-left:1pt; }";\r
48   strNSS +="</style>";\r
49   document.write(strNSS);\r
50 }\r
51 //-->\r
52 </script>\r
53 <script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">\r
54 <!--\r
55 function reDo() {\r
56   if (innerWidth != origWidth || innerHeight != origHeight)\r
57      location.reload();\r
58 }\r
59 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {\r
60         origWidth = innerWidth;\r
61         origHeight = innerHeight;\r
62         onresize = reDo;\r
63 }\r
64 onerror = null; \r
65 //-->\r
66 </script>\r
67 <style type="text/css">\r
68 <!--\r
69 div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }\r
70 p.WebHelpNavBar { text-align:right; }\r
71 -->\r
72 </style><script type="text/javascript" language="javascript1.2" src="../whmsg.js"></script>\r
73 <script type="text/javascript" language="javascript" src="../whver.js"></script>\r
74 <script type="text/javascript" language="javascript1.2" src="../whproxy.js"></script>\r
75 <script type="text/javascript" language="javascript1.2" src="../whutils.js"></script>\r
76 <script type="text/javascript" language="javascript1.2" src="../whtopic.js"></script>\r
77 <script type="text/javascript" language="javascript1.2">\r
78 <!--\r
79 if (window.gbWhTopic)\r
80 {\r
81         if (window.setRelStartPage)\r
82         {\r
83         addTocInfo("MESH module\nCreating meshes\nConstructing meshes");\r
84 addButton("show",BTN_IMG,"Show","","","","",0,0,"../whd_show0.gif","../whd_show2.gif","../whd_show1.gif");\r
85 addButton("hide",BTN_IMG,"Hide","","","","",0,0,"../whd_hide0.gif","../whd_hide2.gif","../whd_hide1.gif");\r
86 \r
87         }\r
88 \r
89 \r
90         if (window.setRelStartPage)\r
91         {\r
92         setRelStartPage("../index.htm");\r
93 \r
94                 autoSync(1);\r
95                 sendSyncInfo();\r
96                 sendAveInfoOut();\r
97         }\r
98 \r
99 }\r
100 else\r
101         if (window.gbIE4)\r
102                 document.location.reload();\r
103 //-->\r
104 </script>\r
105 </head>\r
106 <body><script type="text/javascript" language="javascript1.2">\r
107 <!--\r
108 if (window.writeIntopicBar)\r
109         writeIntopicBar(4);\r
110 //-->\r
111 </script>\r
112 <h1>Constructing meshes</h1>\r
113 \r
114 <p class="whs1">Construction of a mesh consists of:</p>\r
115 \r
116 <p class="whs1">&nbsp;</p>\r
117 \r
118 <ul type="disc" class="whs2">\r
119         \r
120         <li class=kadov-p><p class="whs1">Selecting a geometrical \r
121  object for meshing</p></li>\r
122         \r
123         <li class=kadov-p><p class="whs1">Applying <a href="about_meshing_algorithms.htm">meshing \r
124  algorithms</a> and <a href="about_hypotheses.htm">hypotheses</a> which \r
125  will be used at computation of this mesh.</p></li>\r
126 </ul>\r
127 \r
128 <p class="whs1">&nbsp;</p>\r
129 \r
130 <p class=TODO>To construct a mesh:</p>\r
131 \r
132 <p class="whs3">1. In the <span style="font-weight: bold;"><B>Mesh \r
133  </B></span>menu select<span style="font-weight: bold;"><B> Create Mesh </B></span>or \r
134  click <img src="../image32.gif" width="22px" height="24px" border="0" class="img_whs4"> button in the toolbar. The following dialog box will \r
135  appear:</p>\r
136 \r
137 <p class="whs3">&nbsp;</p>\r
138 \r
139 <p class="whs5"><img src="../pics/createmesh-inv.png" x-maintain-ratio="TRUE" width="370px" height="296px" border="0" class="img_whs6"></p>\r
140 \r
141 <p class="whs5">&nbsp;</p>\r
142 \r
143 <p class="whs3">2. For example, you need to mesh a 3d object. \r
144  </p>\r
145 \r
146 <p class="whs3">First, type the name for your mesh in the \r
147  &quot;Name&quot; box, by default, it is &quot;Mesh_1&quot;. Then select \r
148  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
149  the <img src="../image120.gif" width="34px" height="29px" border="0" class="img_whs8"> &quot;Add&quot; button. </p>\r
150 \r
151 <p class="whs3">Now you can define 1d Algorithm and 1d Hypotheses, \r
152  which will be applied to the edges of your object. (Note that any object \r
153  has edges, even if their existence is not apparent, for example, a sphere \r
154  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
155  to define values for the current hypothesis. The use of additional hypotheses \r
156  is optional (i.e. you may leave &quot;None&quot; in this box). &nbsp;&nbsp;</p>\r
157 \r
158 <p class="whs3">&nbsp;</p>\r
159 \r
160 <p class="whs3">Proceed in the same way with 2d and 3d Algorithms \r
161  and Hypotheses, note that the choice of hypotheses depends on the algorithm. \r
162  There must be one Algorithm and one or several Hypotheses for each dimension \r
163  of your object, otherwise you will not get any mesh at all. Of course, \r
164  if you wish to mesh a face, which is a 2d object, you don't need to define \r
165  3d Algorithm and Hypotheses. </p>\r
166 \r
167 <p class="whs3">In the <span style="font-weight: bold;"><B>Object \r
168  Browser</B></span> the structure of the new mesh will be displayed as follows:</p>\r
169 \r
170 <p class="whs3"><img src="../image88.jpg" width="232px" height="142px" align="right" border="0" class="img_whs11">It contains:</p>\r
171 \r
172 <ul type="disc" class="whs2">\r
173         \r
174         <li class=kadov-p><p class="whs3">a reference to the \r
175  geometrical object on the basis of which the mesh has been constructed;</p></li>\r
176         \r
177         <li class=kadov-p><p class="whs3"><span style="font-weight: bold;"><B>Applied \r
178  hypotheses </B></span>folder containing the references to the hypotheses applied \r
179  to the construction of the mesh;</p></li>\r
180         \r
181         <li class=kadov-p><p class="whs3"><span style="font-weight: bold;"><B>Applied \r
182  algorithms </B></span>folder containing the references to the algorithms applied \r
183  to the construction of the mesh.</p></li>\r
184 </ul>\r
185 \r
186 <p class="whs3">&nbsp;</p>\r
187 \r
188 <p class="whs3">There is an alternative way to create a mesh \r
189  on an object simply by clicking <span style="font-weight: bold;"><B>Assign \r
190  a set of hypotheses </B></span>button and selecting between Automatic Tetrahedralization \r
191  or Hexahedralization. &nbsp;The \r
192  program will automatically generate a 3D mesh with the most appropriate \r
193  settings. In the same way you can apply this functionality for meshing \r
194  2D objects, in which case 3D algorithms are not applied. </p>\r
195 \r
196 <p class="whs3">&nbsp;</p>\r
197 \r
198 <p class="whs3">3. Now, when everything is ready, select \r
199  your mesh in the <span style="font-weight: bold;"><B>Object Browser</B></span>. \r
200  &nbsp;From the \r
201  <span style="font-weight: bold;"><B>Mesh </B></span>menu select<span style="font-weight: bold;"><B> \r
202  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
203  Computation information box appears.</p>\r
204 \r
205 <p class="whs3">&nbsp;</p>\r
206 \r
207 <p class="whs3"><img src="../pics/meshcomputationsucceed.png" x-maintain-ratio="TRUE" width="457px" height="486px" border="0" class="img_whs13"></p>\r
208 \r
209 <p class="whs3">&nbsp;</p>\r
210 \r
211 <p class="whs3">If the mesh computation failed, the information \r
212  about the cause of the failure is provided. </p>\r
213 \r
214 <p class="whs3">&nbsp;</p>\r
215 \r
216 <p class="whs3"><img src="../pics/meshcomputationfail.png" x-maintain-ratio="TRUE" width="564px" height="402px" border="0" class="img_whs14"> </p>\r
217 \r
218 <p class="whs3">&nbsp;</p>\r
219 \r
220 <p class="whs3">After you select the error, <span style="font-weight: bold;"><B>Show \r
221  Subshape</B></span> button allows visualizing the mesh elements that cause \r
222  it</p>\r
223 \r
224 <p class="whs3">&nbsp;</p>\r
225 \r
226 <p class="whs3"><img src="../pics/failed_computation.png" x-maintain-ratio="TRUE" width="260px" height="270px" border="0" class="img_whs15"> </p>\r
227 \r
228 <p class="whs3">&nbsp;</p>\r
229 \r
230 <p class="whs3"><span style="font-weight: bold;"><B>Publish \r
231  Subshape</B></span> button allows importing it in a separate MED or UNV file. \r
232  </p>\r
233 \r
234 <p class="whs3">&nbsp;</p>\r
235 \r
236 <table x-use-null-cells width="67.18%" cellspacing="0" class="whs16">\r
237 <col class="whs17">\r
238 <col class="whs18">\r
239 \r
240 <tr valign="top" class="whs19">\r
241 <td width="65.545%" class="whs20">\r
242 <p class="whs21"><span style="font-weight: bold;"><B>Note:</B></span> \r
243  It is possible to define a 1D or a 2D mesh in a python script and then \r
244  use such submeshes in the construction of a 3D mesh. For this, there exist \r
245  two algorithms: <span style="font-weight: bold;"><B>Use existing edges</B></span> \r
246  and <span style="font-weight: bold;"><B>Use existing faces</B></span>. They are \r
247  not entirely usable from the GUI, so a mesh created using these algorithms \r
248  should be exported into a python script, edited and then imported into \r
249  the GUI. </td>\r
250 <td width="34.455%" class="whs22">\r
251 <p><img src="../image162.gif" width="214px" height="240px" border="0" class="img_whs23"></td></tr>\r
252 </table>\r
253 \r
254 <p class="whs24">&nbsp;</p>\r
255 \r
256 <p class="whs3">&nbsp;</p>\r
257 \r
258 <p class="whs3">Consider trying a sample script for construction \r
259  of a mesh from our <a href="../constructing_meshes.htm">TUI Scripts</a> \r
260  section.</p>\r
261 \r
262 <p class="whs3">&nbsp;</p>\r
263 \r
264 <p>&nbsp;</p>\r
265 \r
266 <script type="text/javascript" language="javascript1.2">\r
267 <!--\r
268 if (window.writeIntopicBar)\r
269         writeIntopicBar(0);\r
270 //-->\r
271 </script>\r
272 </body>\r
273 </html>\r