Model.elementtesttetracollapse

Model.elementtesttetracollapse(collection, collapseval, outputcollection, contour, title)

Tests tetra elements for whether or not they pass the tetra collapse element quality check, and puts those that fail on the specified outputcollection.

Parameters:

• collection (Collection) – The collection containing the element entities to test.

• collapseval (double) – The value to use as a threshold beyond which elements should be considered to have failed the test.

• outputcollection (Collection) – The collection containing the failed element entities.

• contour (int) –

  A code telling if should:

  0 - Display the results of the test normally.

  1 - Display the elements color coded by their ratings.

  2 - Build a histogram showing the distribution of ratings.

• title (hwString) – The title to label the curve in the histogram.

Example

Testing all displayed 3D elements for a tetra collapse value less than 0.5

import hm
import hm.entities as ent

model = hm.Model()

elems1 = model.CreateCollectionByDisplayed(ent.Element)
elems2 = hm.Collection(model, hm.FilterByEnumeration(ent.Element, ids=hm.hwUIntList([])))

model.elementtesttetracollapse(
    collection=elems1,
    collapseval=0.5,
    outputcollection=elems2,
    contour=0,
    title="Tetra Collapse"
)

Note

The details of the skew element quality check can be found in the online help for the Check Elements panel.