Model.hm_getgeomwithlargestitch

Model.hm_getgeomwithlargestitch(tolerance=-1)

The stitch distance between edges, and between vertices are measured and the ones with “large gaps” are identified. The term “large gap” refers to those stitches where the distance is larger than the input tolerance.

Parameters:

tolerance (double) – The distance between stitched edges or vertices are compared against this tolerance. If it is not given, or is less than or equal to 0.0, then the geometry cleanup tolerance is used.

Returns:

• hwReturnStatus - Status object

• HmQueryResult - Result object containing the output values:

  • edgeLargestDistance (double) - The largest stitch distance among the edges that are identified as “large gap”. If no large gap found, 0.0 is returned.

  • vertexLargestDistance (double) - The largest stitch distance among the vertices that are identified as “large gap”. If no large gap found, 0.0 is returned.

  • edgeAverageDistance (double) - The average stitch distance among the edges that are identified as “large gap”. If no large gap found, 0.0 is returned.

  • vertexAverageDistance (double) - The average stitch distance among the vertices that are identified as “large gap”. If no large gap found, 0.0 is returned.

  • surfaceList (EntityList) - The list of all surfaces which has large stitch gaps with neighbor surfaces.

  • lineList (EntityList) - The list of all lines with large stitch gaps.

  • verticesList (EntityList) - The list of all vertices with large stitch gaps.

Example

Get all surfaces , lines and vertices for which the stitch distance is larger than 0.5

import hm
import hm.entities as ent

model = hm.Model()

_, result = model.hm_getgeomwithlargestitch(tolerance=0.5)

print("edgeLargestDistance", result.edgeLargestDistance)
print("vertexLargestDistance", result.vertexLargestDistance)
print("edgeAverageDistance", result.edgeAverageDistance)
print("vertexAverageDistance", result.vertexAverageDistance)
print("surfaceList", result.surfaceList)
print("lineList", result.lineList)
print("verticesList", result.verticesList)