Model.findfaces#

Model.findfaces(collection, componentname='^faces', componentprefix='', cluster_index=UINT_MAX, color='#FF0000')#

Finds the free faces in a group of elements.

Parameters:
  • collection (Collection) – The collection containing the input entities. The valid types are components and elements.

  • componentname (hwString) – The name of the component containing the elements representing the free faces (default “^faces”).

  • componentprefix (hwString) – If given, creates visualizations in new components whose name is derived from the parent component of one of the attached elements. The format is “<prefix>_<original name>_#” where original name is the name of the parent component and # is a numerical suffix that is incremented each time the function is called on the same component.

  • cluster_index (unsigned int) – If given, groups the faces into clusters of connected groups and only creates shell elements for the n-th cluster. If n is more than the number of clusters, shell elements are created for all clusters.

  • color (hwString) – Reserved for future development.

Example#

Check the free faces on all of the elements contained in the component fender#
import hm
import hm.entities as ent

model = hm.Model()

comps = hm.Collection(model, ent.Component, "name=fender")

model.findfaces(collection=comps)