1 <!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">
\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
11 if (navigator.appName !="Netscape")
\r
12 { document.write("<link rel='stylesheet' href='../default.css'>");}
\r
17 A:visited { color:#800080; }
\r
18 A:link { color:#0000ff; }
\r
20 </style><style type="text/css">
\r
22 p.whs1 { font-size:12pt; }
\r
23 img_whs2 { border:none; float:none; width:30px; height:30px; border-style:none; }
\r
24 p.whs3 { margin-left:40px; }
\r
25 img_whs4 { border:none; width:21px; height:19px; border-style:none; }
\r
26 p.whs5 { font-size:12pt; margin-left:40px; font-weight:bold; }
\r
27 img_whs6 { border:none; width:272px; height:303px; float:none; border-style:none; }
\r
28 p.whs7 { font-family:'Times New Roman' , serif; font-size:14pt; }
\r
29 img_whs8 { width:20px; height:20px; border-style:none; }
\r
30 p.whs9 { font-family:'Times New Roman' , serif; font-size:12pt; }
\r
31 img_whs10 { border:none; width:360px; height:307px; float:none; border-style:none; }
\r
32 p.whs11 { font-size:12pt; margin-left:40px; }
\r
33 img_whs12 { border:none; width:312px; height:367px; float:none; border-style:none; }
\r
34 p.whs13 { font-size:12pt; margin-left:400px; }
\r
35 img_whs14 { border:none; width:360px; height:333px; float:none; border-style:none; }
\r
36 p.whs15 { font-size:12pt; font-weight:bold; }
\r
37 img_whs16 { border:none; width:360px; height:328px; float:none; border-style:none; }
\r
38 p.whs17 { font-size:12pt; font-weight:normal; }
\r
39 img_whs18 { border:none; width:360px; height:290px; float:none; border-style:none; }
\r
40 img_whs19 { border:none; width:360px; height:405px; float:none; border-style:none; }
\r
41 img_whs20 { border:none; width:360px; height:309px; float:none; border-style:none; }
\r
42 p.whs21 { font-size:12pt; margin-left:40px; text-indent:-40px; }
\r
43 img_whs22 { border:none; width:25px; height:23px; border-style:none; }
\r
44 ul.whs23 { list-style:disc; }
\r
45 img_whs24 { border:none; width:329px; height:436px; float:none; border-style:none; }
\r
47 </style><script type="text/javascript" language="JavaScript">
\r
49 if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))
\r
51 var strNSS = "<style type='text/css'>";
\r
52 strNSS += "p.whs21 {text-indent:1pt; }";
\r
53 strNSS +="</style>";
\r
54 document.write(strNSS);
\r
58 <script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">
\r
61 if (innerWidth != origWidth || innerHeight != origHeight)
\r
64 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
\r
65 origWidth = innerWidth;
\r
66 origHeight = innerHeight;
\r
72 <style type="text/css">
\r
74 div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }
\r
76 </style><script type="text/javascript" language="javascript1.2" src="../whmsg.js"></script>
\r
77 <script type="text/javascript" language="javascript" src="../whver.js"></script>
\r
78 <script type="text/javascript" language="javascript1.2" src="../whproxy.js"></script>
\r
79 <script type="text/javascript" language="javascript1.2" src="../whutils.js"></script>
\r
80 <script type="text/javascript" language="javascript1.2" src="../whtopic.js"></script>
\r
82 <body><script type="text/javascript" language="javascript1.2">
\r
84 if (window.gbWhTopic)
\r
86 if (window.addTocInfo)
\r
88 addTocInfo("GEOM module\nUsing measurement tools");
\r
89 addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");
\r
92 if (window.writeBtnStyle)
\r
95 if (window.writeIntopicBar)
\r
98 if (window.setRelStartPage)
\r
100 setRelStartPage("../geom.htm");
\r
109 document.location.reload();
\r
112 <h1>Using measurement tools</h1>
\r
114 <p class="whs1"><b style="font-weight: normal;"><img src="../i_blue.jpg" x-maintain-ratio="TRUE" x-save-file="TRUE" x-save-method="compute-relative" width="30px" height="30px" border="0" class="img_whs2">Measurement tools in GEOM are necessary for getting</b> different
\r
115 data concerning created or imported geometrical objects. They are:</p>
\r
117 <p class="whs1"> </p>
\r
121 <li class=kadov-p><p class="whs1"><a href="#PointCoord">Point
\r
122 coordinates</a></p></li>
\r
124 <li class=kadov-p><p class="whs1"><a href="#Basic_properties">Basic
\r
125 properties</a></p></li>
\r
127 <li class=kadov-p><p class="whs1"><a href="#Center_gravity">Center
\r
128 of mass</a></p></li>
\r
130 <li class=kadov-p><p class="whs1"><a href="#Inertia_axis">Inertia</a></p></li>
\r
132 <li class=kadov-p><p class="whs1"><a href="#Bounding_box">Bounding
\r
135 <li class=kadov-p><p class="whs1"><a href="#Min_distance">Min.
\r
136 distance</a></p></li>
\r
138 <li class=kadov-p><p class="whs1"><a href="#Tolerance">Tolerance</a></p></li>
\r
140 <li class=kadov-p><p class="whs1"><a href="#Whatis">WhatIs</a></p></li>
\r
142 <li class=kadov-p><p class="whs1"><a href="#check">Check</a></p></li>
\r
144 <li class=kadov-p><p class="whs1"><a href="#Check_comp_blocks">Check
\r
145 compound of blocks</a></p></li>
\r
148 <p class="whs1"> </p>
\r
150 <p class="whs1">Our <span style="font-weight: bold;"><B>TUI Scripts</B></span>
\r
151 show how to use <a href="../measurement_tools.htm">Measurement Tools</a>
\r
152 with <span style="font-weight: bold;"><B>TUI
\r
153 commands</B></span>. </p>
\r
155 <p class="whs1"> </p>
\r
157 <p class=TODO>To use measurement tools:</p>
\r
159 <p class=TODO> </p>
\r
161 <p class="whs3">In the main menu select <span style="font-weight: bold;"><B>Measures
\r
162 </B></span>submenu.</p>
\r
164 <p class="whs3"> </p>
\r
166 <p class="whs1"> </p>
\r
168 <p class="whs1"><a name=PointCoord> <img src="../image49.gif" width="21px" height="19px" border="0" class="img_whs4"> <span style="font-weight: bold; font-size: 14pt;"><font size=4 style="font-size:14pt;"><B>Point coordinates</B></font></span></a></p>
\r
170 <p class="whs1"> </p>
\r
172 <p class="whs1"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"><b style="font-weight: bold;">Description:</b>
\r
173 Returns the coordinates of a point.</font></span></p>
\r
175 <p class="whs1"> </p>
\r
177 <p class="whs1"><b style="font-weight: bold;">Result:</b> Point
\r
178 coordinates (X, Y, Z) in 3D space in the form of Python Tuple.</p>
\r
180 <p class="whs1"> </p>
\r
182 <p class="whs1"><span style="font-weight: bold;"><B>TUI command:</B></span>
\r
183 <span style="font-style: italic;"><I>geompy.PointCoordinates(Point)</I></span>,
\r
184 where Point is a point whose coordinates are inquired.</p>
\r
186 <p class="whs1"> </p>
\r
188 <p class="whs1"> </p>
\r
190 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
193 <p class="whs1"> </p>
\r
195 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
197 <p class="whs1"> </p>
\r
199 <p class="whs5"><img src="../pics/measures1.png" x-maintain-ratio="TRUE" width="272px" height="303px" border="0" class="img_whs6"></p>
\r
201 <p class="whs1"> </p>
\r
203 <p class="whs1"> </p>
\r
205 <p class="whs7"><b style="font-weight: bold;"><a
\r
206 NAME=Basic_properties
\r
207 style="font-size: 14pt;"><img src="salome2_sp3_measuregui_functions_salome2_sp3_measuregui_functions_image71.gif" width="20px" height="20px" border="0" class="img_whs8"> Basic properties</a></b>
\r
210 <p class="whs9"> </p>
\r
212 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
213 Return the properties (Length, Surface & Volume) of a definite geometrical
\r
216 <p class="whs1"> </p>
\r
218 <p class="whs1"><b style="font-weight: bold;">Result:</b> Display
\r
219 Length, Surface & Volume in the form of Python Tuple.</p>
\r
221 <p class="whs1"> </p>
\r
223 <p class="whs1"><span style="font-weight: bold;"><B>TUI command:</B></span>
\r
224 <span style="font-style: italic;"><I>geompy.BasicProperties(Shape)</I></span>,
\r
225 where Shape is a shape whose properties are inquired.</p>
\r
227 <p class="whs1"> </p>
\r
229 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
232 <p class="whs1"> </p>
\r
234 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
236 <p class="whs1"> </p>
\r
238 <p class="whs3"><img src="../pics/neo-basicprop.png" x-maintain-ratio="TRUE" width="360px" height="307px" border="0" class="img_whs10"></p>
\r
244 <p class="whs7"><a name=Center_gravity
\r
245 style="font-size: 14pt;"><img src="salome2_sp3_measuregui_functions_salome2_sp3_measuregui_functions_image72.gif" width="20px" height="20px" border="0" class="img_whs8"><b style="font-size: 14pt;">
\r
246 Center of mass</b></a></p>
\r
248 <p class="whs9"> </p>
\r
250 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
251 Creates a gravity center of a shape and returns its coordinates.</p>
\r
253 <p class="whs1"> </p>
\r
255 <p class="whs1"><b style="font-weight: bold;">Result:</b> GEOM_Object
\r
258 <p class="whs1"> </p>
\r
260 <p class="whs1"><b style="font-weight: bold;">TUI Command:</b><i>
\r
261 </i><span style="font-style: italic;"><I>geompy.MakeCDG(Shape)</I></span>, where
\r
262 Shape is the shape for which a center of gravity is computed.</p>
\r
264 <p class="whs1"> </p>
\r
266 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
269 <p class="whs1"> </p>
\r
271 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
273 <p class="whs1"> </p>
\r
275 <p class="whs11"><img src="../pics/measures3.png" x-maintain-ratio="TRUE" width="312px" height="367px" border="0" class="img_whs12"></p>
\r
277 <p class="whs1"> </p>
\r
279 <p class="whs7"> </p>
\r
281 <p class="whs7"><a NAME=Inertia_axis
\r
282 style="font-size: 14pt;"><img src="salome2_sp3_measuregui_functions_salome2_sp3_measuregui_functions_image73.gif" width="20px" height="20px" border="0" class="img_whs8"><b><font style="font-size: 14pt;"
\r
283 size=4> Inertia</font></b></a>
\r
286 <p class="whs7"> </p>
\r
288 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
289 Returns the inertia axis of a geometrical object.</p>
\r
291 <p class="whs1"> </p>
\r
293 <p class="whs1"><b style="font-weight: bold;">Result:</b> Display
\r
294 the matrix and moments of inertia in the form of Python Tuple (I11, I12,
\r
297 <p class="whs13"> I21,
\r
300 <p class="whs13"> I31,
\r
303 <p class="whs13"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"> Ix,
\r
304 Iy, Iz)</font></span>.</p>
\r
306 <p class="whs1"> </p>
\r
308 <p class="whs1"><span style="font-weight: bold;"><B>TUI command:</B></span>
\r
309 <span style="font-style: italic;"><I>geompy.Inertia(Shape)</I></span>, where
\r
310 Shape is a shape for which a matrix of inertia and moment of inertia are
\r
313 <p class="whs1"> </p>
\r
315 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
318 <p class="whs1"> </p>
\r
320 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
322 <p class="whs11"> </p>
\r
324 <p class="whs11"><img src="../pics/measures4.png" x-maintain-ratio="TRUE" width="360px" height="333px" border="0" class="img_whs14"></p>
\r
326 <p class="whs1"> </p>
\r
328 <p class="whs1"> </p>
\r
330 <p class="whs7"><a NAME=Bounding_box
\r
331 style="font-size: 14pt;"><img src="salome2_sp3_measuregui_functions_salome2_sp3_measuregui_functions_image74.gif" width="20px" height="20px" border="0" class="img_whs8"><b><font style="font-size: 14pt;"
\r
333 box</font></b></a> </p>
\r
335 <p class="whs7"> </p>
\r
337 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
338 Returns the dimensions of the bounding box of a geometrical object.</p>
\r
340 <p class="whs1"> </p>
\r
342 <p class="whs1"><b style="font-weight: bold;">Result:</b> Displays
\r
343 the dimensions of the bounding box of a geometrical object in the form
\r
344 of Python Tuple (Xmin, Xmax, Ymin, Ymax, Zmin, Zmax).</p>
\r
346 <p class="whs1"> </p>
\r
348 <p class="whs15">TUI command: <span style="font-weight: normal; font-style: italic;"><I>geompy.BoundingBox(Shape)</I></span><span
\r
349 style="font-weight: normal;">, where Shape is a shape for which a bounding
\r
350 box is computed.</span></p>
\r
352 <p class="whs1"> </p>
\r
354 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
357 <p class="whs1"> </p>
\r
359 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
361 <p class="whs1"> </p>
\r
363 <p class="whs11"><img src="../pics/measures5.png" x-maintain-ratio="TRUE" width="360px" height="328px" border="0" class="img_whs16"></p>
\r
365 <p class="whs1"> </p>
\r
367 <p class="whs1"> </p>
\r
369 <p class="whs7"><a NAME=Min_distance
\r
370 style="font-size: 14pt;"><img src="salome2_sp3_measuregui_functions_salome2_sp3_measuregui_functions_image75.gif" width="20px" height="20px" border="0" class="img_whs8"><b><font style="font-size: 14pt;"
\r
371 size=4> Min. distance</font></b></a></p>
\r
373 <p class="whs7"> </p>
\r
375 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
376 Returns the min. distance between 2 geometrical objects.</p>
\r
378 <p class="whs1"> </p>
\r
380 <p class="whs1"><b style="font-weight: bold;">Result:</b> Displays
\r
381 the min. distance.</p>
\r
383 <p class="whs1"> </p>
\r
385 <p class="whs15">TUI command: <span style="font-weight: normal; font-style: italic;"><I>geompy.MinDistance(Shape1,
\r
386 Shape2)</I></span><span style="font-weight: normal;">, where Shape1 and Shape2
\r
387 are shapes between which the minimal distance computed.</span></p>
\r
389 <p class="whs17"> </p>
\r
391 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
394 <p class="whs1"> </p>
\r
396 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
398 <p class="whs1"> </p>
\r
400 <p class="whs11"><img src="../pics/distance.png" x-maintain-ratio="TRUE" width="360px" height="290px" border="0" class="img_whs18"></p>
\r
402 <p class="whs1"> </p>
\r
404 <p class="whs1"> </p>
\r
406 <p class="whs7"><a NAME=Tolerance
\r
407 style="font-size: 14pt;"><img src="salome2_sp3_measuregui_functions_salome2_sp3_measuregui_functions_image76.gif" width="20px" height="20px" border="0" class="img_whs8"><b style="font-size: 14pt;">
\r
408 Tolerance</b></a> </p>
\r
410 <p class="whs9"> </p>
\r
412 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
413 Returns the tolerance of a geometrical object.</p>
\r
415 <p class="whs1"> </p>
\r
417 <p class="whs1"><b style="font-weight: bold;">Result:</b> Displays
\r
418 the tolerance values (FaceMinTol, FaceMaxTol, EgdeMinTol, EgdeMaxTol,
\r
419 VertexMinTol, VertexMaxTol).</p>
\r
421 <p class="whs1"> </p>
\r
423 <p class="whs15">TUI command: <span style="font-weight: normal; font-style: italic;"><I>geompy.Tolerance(Shape)</I></span><span
\r
424 style="font-weight: normal;">, where Shape is a shape for which minimal
\r
425 and maximal tolerances are returned.</span></p>
\r
427 <p class="whs1"> </p>
\r
429 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
432 <p class="whs1"> </p>
\r
434 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
436 <p class="whs1"> </p>
\r
438 <p class="whs11"><img src="../pics/new-tolerance.png" x-maintain-ratio="TRUE" width="360px" height="328px" border="0" class="img_whs16"></p>
\r
440 <p class="whs1"> </p>
\r
442 <p class="whs1"> </p>
\r
444 <p class="whs7"><a NAME=Whatis><span
\r
445 style="font-size: 14pt;"><font size=4 style="font-size:14pt;"><img src="salome2_sp3_measuregui_functions_salome2_sp3_measuregui_functions_image77.gif" width="20px" height="20px" border="0" class="img_whs8"><b style="font-size: 14pt;"> WhatIs</b></a>
\r
448 <p class="whs9"> </p>
\r
450 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
451 Returns the type of a geometrical object.</p>
\r
453 <p class="whs1"> </p>
\r
455 <p class="whs1"><b style="font-weight: bold;">Result:</b> Displays
\r
456 all elements composing your geometrical object.</p>
\r
458 <p class="whs1"> </p>
\r
460 <p class="whs1"><span style="font-weight: bold;"><B>TUI command:</B></span>
\r
461 <span style="font-style: italic;"><I>geompy.WhatIs(Shape)</I></span>, where Shape
\r
462 is a shape from which a description is returned.</p>
\r
464 <p class="whs1"> </p>
\r
466 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
469 <p class="whs1"> </p>
\r
471 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
473 <p class="whs1"> </p>
\r
475 <p class="whs11"><img src="../pics/measures8.png" x-maintain-ratio="TRUE" width="360px" height="405px" border="0" class="img_whs19"></p>
\r
477 <p class="whs11"> </p>
\r
479 <p class="whs11"> </p>
\r
481 <p class="whs7"><a NAME=check
\r
482 style="font-size: 14pt;"><img src="salome2_sp3_measuregui_functions_salome2_sp3_measuregui_functions_image78.gif" width="20px" height="20px" border="0" class="img_whs8"><b><font style="font-size: 14pt;"
\r
483 size=4> Check</font></b></a>
\r
486 <p class="whs7"> </p>
\r
488 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
489 Returns True if this geometrical object is valid.</p>
\r
491 <p class="whs1"> </p>
\r
493 <p class="whs1"><b style="font-weight: bold;">Result:</b> Boolean.</p>
\r
495 <p class="whs1"> </p>
\r
497 <p class="whs1"><b style="font-weight: bold;">TUI Command:</b><i>
\r
498 </i><span style="font-style: italic;"><I>geompy.CheckShape(Shape)</I></span>,
\r
499 where is shape which is checked for validity.</p>
\r
501 <p class="whs1"> </p>
\r
503 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
506 <p class="whs1"> </p>
\r
508 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
510 <p class="whs1"> </p>
\r
512 <p class="whs11"><img src="../pics/measures9.png" x-maintain-ratio="TRUE" width="360px" height="309px" border="0" class="img_whs20"></p>
\r
514 <p class="whs11"> </p>
\r
516 <p class="whs21"> </p>
\r
518 <p class="whs21"> </p>
\r
520 <p class="whs21"><a name=Check_comp_blocks><img src="../image27.gif" width="25px" height="23px" border="0" class="img_whs22"> <span style="font-size: 14pt; font-weight: bold;"><font size=4 style="font-size:14pt;"><B>Check compound
\r
521 of blocks</B></font></span></a></p>
\r
523 <p class="whs21"> </p>
\r
525 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
526 Checks whether a shape is a compound of glued blocks. To be considered
\r
527 as a compound of blocks, the given shape must satisfy the following conditions:</p>
\r
529 <ul type="disc" class="whs23">
\r
531 <li class=kadov-p><p class="whs1"> Each
\r
532 element of the compound should be a Block (6 faces and 12 edges);</p></li>
\r
534 <li class=kadov-p><p class="whs1"> A
\r
535 connection between two Blocks should be an entire quadrangle face or an
\r
536 entire edge;</p></li>
\r
538 <li class=kadov-p><p class="whs1"> The
\r
539 compound should be connected;</p></li>
\r
541 <li class=kadov-p><p class="whs1"> Two
\r
542 quadrangle faces should be glued. </p></li>
\r
545 <p class="whs1"> </p>
\r
547 <p class="whs1">Informs of the following possible errors:</p>
\r
549 <ul type="disc" class="whs23">
\r
551 <li class=kadov-p><p class="whs1">not a block,</p></li>
\r
553 <li class=kadov-p><p class="whs1">not glued,</p></li>
\r
555 <li class=kadov-p><p class="whs1">not connected,</p></li>
\r
557 <li class=kadov-p><p class="whs1"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;">extra
\r
558 or degenerated edge.</font></span></p></li>
\r
561 <p class="whs1"> </p>
\r
563 <p class="whs1"><b style="font-weight: bold;">Result:</b> Boolean;
\r
564 highlight in the viewer.</p>
\r
566 <p class="whs1"> </p>
\r
568 <p class="whs1"><b>TUI Command:</b><i> </i><span style="font-style: italic;"><I>geompy.CheckCompoundOfBlocks(Compound).
\r
569 </I></span>Checks if the<span style="font-style: italic;"> <I></I></span>shape is
\r
570 a valid compound of blocks. If it is true, then the validity flag is returned,
\r
571 and encountered errors are printed in the python console.</p>
\r
573 <p class="whs1"> </p>
\r
575 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
578 <p class="whs1"> </p>
\r
580 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
582 <p class="whs11"> </p>
\r
584 <p class="whs11"><img src="../pics/measures10.png" x-maintain-ratio="TRUE" width="329px" height="436px" border="0" class="img_whs24"></p>
\r
586 <p class="whs11"> </p>
\r
588 <script type="text/javascript" language="javascript1.2">
\r
590 if (window.writeIntopicBar)
\r
591 writeIntopicBar(0);
\r