Salome HOME
Merge remote-tracking branch 'origin/master'
[modules/geom.git] / doc / salome / gui / GEOM / input / min_distance.doc
1 /*! 
2
3 \page min_distance_page Minimum Distance
4
5 This operation returns the minimum distance between two geometrical objects.
6
7 \image html distance.png
8
9 The query for minimum distance can find one or more solutions, or even an infinite set of solutions. 
10 However, the currently used OCCT algorithm finds a finite number of
11 solutions even if an infinite set of solutions exists.
12
13 Select one of the found solutions in the \b Solution list to display it in the Viewer show values corresponding to this solution in the following fields:
14 - \b Length - the distance value;
15 - \b DX, \b DY and \b DZ the vector coordinates. 
16
17 Press \b Apply or <b>Apply and Close</b> button to create a set of closest
18 points, corresponding to all found solutions.
19
20 <b>TUI Commands:</b>
21 \n<em>aDist = geompy.MinDistance(Shape1, Shape2),</em>
22 \n<em>[aDist, DX, DY, DZ] = geompy.MinDistanceComponents(Shape1, Shape2),</em>
23 \n<em>[nbSols, (x11, y11, z11, x21, y21, z21, ...)] = geompy.ClosestPoints(Shape1, Shape2),</em>
24 \n where \em Shape1 and \em Shape2 are the shapes, between which the minimal
25 distance is computed.
26
27 See also a \ref tui_min_distance_page "TUI example".
28
29 */