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:216px; height:250px; 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:283px; height:250px; border-style:none; }
\r
32 p.whs11 { font-size:12pt; margin-left:40px; }
\r
33 img_whs12 { border:none; width:199px; height:250px; border-style:none; }
\r
34 p.whs13 { font-size:12pt; margin-left:400px; }
\r
35 img_whs14 { border:none; width:256px; height:250px; border-style:none; }
\r
36 p.whs15 { font-size:12pt; font-weight:bold; }
\r
37 img_whs16 { border:none; width:263px; height:250px; border-style:none; }
\r
38 p.whs17 { font-size:12pt; font-weight:normal; }
\r
39 img_whs18 { border:none; width:310px; height:250px; border-style:none; }
\r
40 img_whs19 { border:none; width:262px; height:250px; border-style:none; }
\r
41 img_whs20 { border:none; width:268px; height:250px; border-style:none; }
\r
42 img_whs21 { border:none; width:266px; height:250px; border-style:none; }
\r
43 p.whs22 { font-size:12pt; margin-left:40px; text-indent:-40px; }
\r
44 img_whs23 { border:none; width:25px; height:23px; border-style:none; }
\r
45 ul.whs24 { list-style:disc; }
\r
46 img_whs25 { border:none; width:300px; height:374px; border-style:none; }
\r
48 </style><script type="text/javascript" language="JavaScript">
\r
50 if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))
\r
52 var strNSS = "<style type='text/css'>";
\r
53 strNSS += "p.whs22 {text-indent:1pt; }";
\r
54 strNSS +="</style>";
\r
55 document.write(strNSS);
\r
59 <script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">
\r
62 if (innerWidth != origWidth || innerHeight != origHeight)
\r
65 if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
\r
66 origWidth = innerWidth;
\r
67 origHeight = innerHeight;
\r
73 <style type="text/css">
\r
75 div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }
\r
77 </style><script type="text/javascript" language="javascript1.2" src="../whmsg.js"></script>
\r
78 <script type="text/javascript" language="javascript" src="../whver.js"></script>
\r
79 <script type="text/javascript" language="javascript1.2" src="../whproxy.js"></script>
\r
80 <script type="text/javascript" language="javascript1.2" src="../whutils.js"></script>
\r
81 <script type="text/javascript" language="javascript1.2" src="../whtopic.js"></script>
\r
83 <body><script type="text/javascript" language="javascript1.2">
\r
85 if (window.gbWhTopic)
\r
87 if (window.addTocInfo)
\r
89 addTocInfo("GEOM module\nUsing measurement tools");
\r
90 addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");
\r
93 if (window.writeBtnStyle)
\r
96 if (window.writeIntopicBar)
\r
99 if (window.setRelStartPage)
\r
101 setRelStartPage("../geom.htm");
\r
110 document.location.reload();
\r
113 <h1>Using measurement tools</h1>
\r
115 <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
116 data concerning created or imported geometrical objects. They are:</p>
\r
118 <p class="whs1"> </p>
\r
122 <li class=kadov-p><p class="whs1"><a href="#PointCoord">Point
\r
123 coordinates</a></p></li>
\r
125 <li class=kadov-p><p class="whs1"><a href="#Basic_properties">Basic
\r
126 properties</a></p></li>
\r
128 <li class=kadov-p><p class="whs1"><a href="#Center_gravity">Center
\r
129 of mass</a></p></li>
\r
131 <li class=kadov-p><p class="whs1"><a href="#Inertia_axis">Inertia</a></p></li>
\r
133 <li class=kadov-p><p class="whs1"><a href="#Bounding_box">Bounding
\r
136 <li class=kadov-p><p class="whs1"><a href="#Min_distance">Min.
\r
137 distance</a></p></li>
\r
139 <li class=kadov-p><p class="whs1"><a href="#Tolerance">Tolerance</a></p></li>
\r
141 <li class=kadov-p><p class="whs1"><a href="#Whatis">WhatIs</a></p></li>
\r
143 <li class=kadov-p><p class="whs1"><a href="#check">Check</a></p></li>
\r
145 <li class=kadov-p><p class="whs1"><a href="#Check_comp_blocks">Check
\r
146 compound of blocks</a></p></li>
\r
149 <p class="whs1"> </p>
\r
151 <p class=TODO>To use measurement tools:</p>
\r
153 <p class=TODO> </p>
\r
155 <p class="whs3">In the main menu select <span style="font-weight: bold;"><B>Measures
\r
156 </B></span>submenu.</p>
\r
158 <p class="whs3"> </p>
\r
160 <p class="whs1"> </p>
\r
162 <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
164 <p class="whs1"> </p>
\r
166 <p class="whs1"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"><b style="font-weight: bold;">Description:</b>
\r
167 Returns the coordinates of a point.</font></span></p>
\r
169 <p class="whs1"> </p>
\r
171 <p class="whs1"><b style="font-weight: bold;">Result:</b> Point
\r
172 coordinates (X, Y, Z) in 3D space in the form of Python Tuple.</p>
\r
174 <p class="whs1"> </p>
\r
176 <p class="whs1"><span style="font-weight: bold;"><B>TUI command:</B></span>
\r
177 <span style="font-style: italic;"><I>geompy.PointCoordinates(Point)</I></span>,
\r
178 where Point is a point whose coordinates are inquired.</p>
\r
180 <p class="whs1"> </p>
\r
182 <p class="whs1"> </p>
\r
184 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
187 <p class="whs1"> </p>
\r
189 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
191 <p class="whs1"> </p>
\r
193 <p class="whs5"><img src="../image292.jpg" width="216px" height="250px" border="0" class="img_whs6"></p>
\r
195 <p class="whs1"> </p>
\r
197 <p class="whs1"> </p>
\r
199 <p class="whs7"><b style="font-weight: bold;"><a
\r
200 NAME=Basic_properties
\r
201 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
204 <p class="whs9"> </p>
\r
206 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
207 Return the properties (Length, Surface & Volume) of a definite geometrical
\r
210 <p class="whs1"> </p>
\r
212 <p class="whs1"><b style="font-weight: bold;">Result:</b> Display
\r
213 Length, Surface & Volume in the form of Python Tuple.</p>
\r
215 <p class="whs1"> </p>
\r
217 <p class="whs1"><span style="font-weight: bold;"><B>TUI command:</B></span>
\r
218 <span style="font-style: italic;"><I>geompy.BasicProperties(Shape)</I></span>,
\r
219 where Shape is a shape whose properties are inquired.</p>
\r
221 <p class="whs1"> </p>
\r
223 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
226 <p class="whs1"> </p>
\r
228 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
230 <p class="whs1"> </p>
\r
232 <p class="whs3"><img src="../image293.jpg" width="283px" height="250px" border="0" class="img_whs10"></p>
\r
238 <p class="whs7"><a name=Center_gravity
\r
239 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
240 Center of mass</b></a></p>
\r
242 <p class="whs9"> </p>
\r
244 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
245 Creates a gravity center of a shape and returns its coordinates.</p>
\r
247 <p class="whs1"> </p>
\r
249 <p class="whs1"><b style="font-weight: bold;">Result:</b> GEOM_Object
\r
252 <p class="whs1"> </p>
\r
254 <p class="whs1"><b style="font-weight: bold;">TUI Command:</b><i>
\r
255 </i><span style="font-style: italic;"><I>geompy.MakeCDG(Shape)</I></span>, where
\r
256 Shape is the shape for which a center of gravity is computed.</p>
\r
258 <p class="whs1"> </p>
\r
260 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
263 <p class="whs1"> </p>
\r
265 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
267 <p class="whs1"> </p>
\r
269 <p class="whs11"><img src="../image294.jpg" width="199px" height="250px" border="0" class="img_whs12"></p>
\r
271 <p class="whs1"> </p>
\r
273 <p class="whs7"> </p>
\r
275 <p class="whs7"><a NAME=Inertia_axis
\r
276 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
277 size=4> Inertia</font></b></a>
\r
280 <p class="whs7"> </p>
\r
282 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
283 Returns the inertia axis of a geometrical object.</p>
\r
285 <p class="whs1"> </p>
\r
287 <p class="whs1"><b style="font-weight: bold;">Result:</b> Display
\r
288 the matrix and moments of inretia in the form of Python Tuple (I11, I12,
\r
291 <p class="whs13"> I21,
\r
294 <p class="whs13"> I31,
\r
297 <p class="whs13"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;"> Ix,
\r
298 Iy, Iz)</font></span>.</p>
\r
300 <p class="whs1"> </p>
\r
302 <p class="whs1"><span style="font-weight: bold;"><B>TUI command:</B></span>
\r
303 <span style="font-style: italic;"><I>geompy.Inertia(Shape)</I></span>, where
\r
304 Shape is a shape for which a matrix of inertia and moment of inertia are
\r
307 <p class="whs1"> </p>
\r
309 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
312 <p class="whs1"> </p>
\r
314 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
316 <p class="whs11"> </p>
\r
318 <p class="whs11"><img src="../image295.jpg" width="256px" height="250px" border="0" class="img_whs14"></p>
\r
320 <p class="whs1"> </p>
\r
322 <p class="whs1"> </p>
\r
324 <p class="whs7"><a NAME=Bounding_box
\r
325 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
327 box</font></b></a> </p>
\r
329 <p class="whs7"> </p>
\r
331 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
332 Returns the dimensions of the bounding box of a geometrical object.</p>
\r
334 <p class="whs1"> </p>
\r
336 <p class="whs1"><b style="font-weight: bold;">Result:</b> Displays
\r
337 the dimensions of the bounding box of a geometrical object in the form
\r
338 of Python Tuple (Xmin, Xmax, Ymin, Ymax, Zmin, Zmax).</p>
\r
340 <p class="whs1"> </p>
\r
342 <p class="whs15">TUI command: <span style="font-weight: normal; font-style: italic;"><I>geompy.BoundingBox(Shape)</I></span><span
\r
343 style="font-weight: normal;">, where Shape is a shape for which a bounding
\r
344 box is computed.</span></p>
\r
346 <p class="whs1"> </p>
\r
348 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
351 <p class="whs1"> </p>
\r
353 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
355 <p class="whs1"> </p>
\r
357 <p class="whs11"><img src="../image296.jpg" width="263px" height="250px" border="0" class="img_whs16"></p>
\r
359 <p class="whs1"> </p>
\r
361 <p class="whs1"> </p>
\r
363 <p class="whs7"><a NAME=Min_distance
\r
364 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
365 size=4> Min. distance</font></b></a></p>
\r
367 <p class="whs7"> </p>
\r
369 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
370 Returns the min. distance between 2 geometrical objects.</p>
\r
372 <p class="whs1"> </p>
\r
374 <p class="whs1"><b style="font-weight: bold;">Result:</b> Displays
\r
375 the min. distance.</p>
\r
377 <p class="whs1"> </p>
\r
379 <p class="whs15">TUI command: <span style="font-weight: normal; font-style: italic;"><I>geompy.MinDistance(Shape1,
\r
380 Shape2)</I></span><span style="font-weight: normal;">, where Shape1 and Shape2
\r
381 are shapes between which the minimal distance computed.</span></p>
\r
383 <p class="whs17"> </p>
\r
385 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
388 <p class="whs1"> </p>
\r
390 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
392 <p class="whs1"> </p>
\r
394 <p class="whs11"><img src="../image297.jpg" width="310px" height="250px" border="0" class="img_whs18"></p>
\r
396 <p class="whs1"> </p>
\r
398 <p class="whs1"> </p>
\r
400 <p class="whs7"><a NAME=Tolerance
\r
401 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
402 Tolerance</b></a> </p>
\r
404 <p class="whs9"> </p>
\r
406 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
407 Returns the tolerance of a geometrical object.</p>
\r
409 <p class="whs1"> </p>
\r
411 <p class="whs1"><b style="font-weight: bold;">Result:</b> Displays
\r
412 the tolerance values (FaceMinTol, FaceMaxTol, EgdeMinTol, EgdeMaxTol,
\r
413 VertexMinTol, VertexMaxTol).</p>
\r
415 <p class="whs1"> </p>
\r
417 <p class="whs15">TUI command: <span style="font-weight: normal; font-style: italic;"><I>geompy.Tolerance(Shape)</I></span><span
\r
418 style="font-weight: normal;">, where Shape is a shape for which minimal
\r
419 and maximal tolerances are returned.</span></p>
\r
421 <p class="whs1"> </p>
\r
423 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
426 <p class="whs1"> </p>
\r
428 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
430 <p class="whs1"> </p>
\r
432 <p class="whs11"><img src="../image298.jpg" width="262px" height="250px" border="0" class="img_whs19"></p>
\r
434 <p class="whs1"> </p>
\r
436 <p class="whs1"> </p>
\r
438 <p class="whs7"><a NAME=Whatis><span
\r
439 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
442 <p class="whs9"> </p>
\r
444 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
445 Returns the type of a geometrical object.</p>
\r
447 <p class="whs1"> </p>
\r
449 <p class="whs1"><b style="font-weight: bold;">Result:</b> Displays
\r
450 all elements composing your geometrical object.</p>
\r
452 <p class="whs1"> </p>
\r
454 <p class="whs1"><span style="font-weight: bold;"><B>TUI command:</B></span>
\r
455 <span style="font-style: italic;"><I>geompy.WhatIs(Shape)</I></span>, where Shape
\r
456 is a shape from which a description is returned.</p>
\r
458 <p class="whs1"> </p>
\r
460 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
463 <p class="whs1"> </p>
\r
465 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
467 <p class="whs1"> </p>
\r
469 <p class="whs11"><img src="../image299.jpg" width="268px" height="250px" border="0" class="img_whs20"></p>
\r
471 <p class="whs11"> </p>
\r
473 <p class="whs11"> </p>
\r
475 <p class="whs7"><a NAME=check
\r
476 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
477 size=4> Check</font></b></a>
\r
480 <p class="whs7"> </p>
\r
482 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
483 Returns True if this geometrical object is valid.</p>
\r
485 <p class="whs1"> </p>
\r
487 <p class="whs1"><b style="font-weight: bold;">Result:</b> Boolean.</p>
\r
489 <p class="whs1"> </p>
\r
491 <p class="whs1"><b style="font-weight: bold;">TUI Command:</b><i>
\r
492 </i><span style="font-style: italic;"><I>geompy.CheckShape(Shape)</I></span>,
\r
493 where is shape which is checked for validity.</p>
\r
495 <p class="whs1"> </p>
\r
497 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
500 <p class="whs1"> </p>
\r
502 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
504 <p class="whs1"> </p>
\r
506 <p class="whs11"><img src="../image300.jpg" width="266px" height="250px" border="0" class="img_whs21"></p>
\r
508 <p class="whs11"> </p>
\r
510 <p class="whs22"> </p>
\r
512 <p class="whs22"> </p>
\r
514 <p class="whs22"><a name=Check_comp_blocks><img src="../image27.gif" width="25px" height="23px" border="0" class="img_whs23"> <span style="font-size: 14pt; font-weight: bold;"><font size=4 style="font-size:14pt;"><B>Check compound
\r
515 of blocks</B></font></span></a></p>
\r
517 <p class="whs22"> </p>
\r
519 <p class="whs1"><b style="font-weight: bold;">Description:</b>
\r
520 Checks whether a shape is a compound of glued blocks. To be considered
\r
521 as a compound of blocks, the given shape must satisfy the following conditions:</p>
\r
523 <ul type="disc" class="whs24">
\r
525 <li class=kadov-p><p class="whs1"> Each
\r
526 element of the compound should be a Block (6 faces and 12 edges);</p></li>
\r
528 <li class=kadov-p><p class="whs1"> A
\r
529 connection between two Blocks should be an entire quadrangle face or an
\r
530 entire edge;</p></li>
\r
532 <li class=kadov-p><p class="whs1"> The
\r
533 compound should be connected;</p></li>
\r
535 <li class=kadov-p><p class="whs1"> Two
\r
536 quadrangle faces should be glued. </p></li>
\r
539 <p class="whs1"> </p>
\r
541 <p class="whs1">Informs of the following possible errors:</p>
\r
543 <ul type="disc" class="whs24">
\r
545 <li class=kadov-p><p class="whs1">not a block,</p></li>
\r
547 <li class=kadov-p><p class="whs1">not glued,</p></li>
\r
549 <li class=kadov-p><p class="whs1">not connected,</p></li>
\r
551 <li class=kadov-p><p class="whs1"><span style="font-size: 12pt;"><font size=3 style="font-size:12pt;">extra
\r
552 or degenerated edge.</font></span></p></li>
\r
555 <p class="whs1"> </p>
\r
557 <p class="whs1"><b style="font-weight: bold;">Result:</b> Boolean;
\r
558 highlight in the viewer.</p>
\r
560 <p class="whs1"> </p>
\r
562 <p class="whs1"><b>TUI Command:</b><i> </i><span style="font-style: italic;"><I>geompy.CheckCompoundOfBlocks(Compound)</I></span>,
\r
563 where the Compound is a shape, investigated in order to see, if it is
\r
564 a valid compound of blocks. Validity flag is returned, encountered errors
\r
565 are printed in the python console.</p>
\r
567 <p class="whs1"> </p>
\r
569 <p class="whs1"><b style="font-weight: bold;">Arguments:</b>
\r
572 <p class="whs1"> </p>
\r
574 <p class="whs1"><b style="font-weight: bold;">Dialog Box:</b></p>
\r
576 <p class="whs11"> </p>
\r
578 <p class="whs11"><img src="../image13.jpg" width="300px" height="374px" border="0" class="img_whs25"></p>
\r
580 <p class="whs11"> </p>
\r
582 <script type="text/javascript" language="javascript1.2">
\r
584 if (window.writeIntopicBar)
\r
585 writeIntopicBar(0);
\r