NXOpen.UF.Modeling.AskMinimumDist3

Modeling.AskMinimumDist3()

Refer to UF_MODL_ask_minimum_dist_3 for documentation.

Signature: AskMinimumDist3(optLevel, object1, object2, guess1Given, guess1, guess2Given, guess2)

Parameters:
  • optLevel (int) – 0, works the same as UF_MODL_ask_minimum_dist_2 1, uses a newer algorithm but should give the same results 2, should produce more accurate results in some cases, and just as good in all cases
  • object1 (Tag) – First object (if NULL_TAG, the point coordinates in guess1 are used instead)
  • object2 (Tag) –

    Second object (if NULL_TAG, the point coordinates in guess2 are used instead)

    If object1 and object2 are both NULL_TAG the distance from guess1 to guess2 is computed.

  • guess1Given (int) – 1 - if a guess point for object1 is specified 0 otherwise Ignored if object1 is a body
  • guess1 (list of float) – Guess for the nearest point on object1, or point coordinates to use in the distance computation if object1 is a NULL_TAG. Ignored if object1 is a body.
  • guess2Given (int) – 1 - if a guess point for object2 is specified 0 otherwise Ignored if object2 is a body
  • guess2 (list of float) – Guess for the nearest point on object2, or point coordinates to use in the distance computation if object2 is a NULL_TAG. Ignored if object2 is a body.
Returns:

A Tuple

Return type:

A tuple consisting of (min_dist,pt_on_obj1,pt_on_obj2,accuracy)

min_dist(float): Resultant minimum distance.

pt_on_obj1(list of float): Minimum distance Point on object1.

pt_on_obj2(list of float): Minimum distance Point on object2.

accuracy(float): Size of absolute error resulting from the use of faceted rather than solid bodies. 0.0 is output if neither body is faceted.

License requirements: None