Model.elementtestcellsquish

Model.elementtestcellsquish(collection, cell_squish, output_collection, dimension, contour, title)

Tests 2D and 3D elements using the cell squish element quality check.

Parameters:

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

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

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

• dimension (int) –

  A code telling to measure the dimension of:

  2 - Measure 2D elements.

  4 - Measure 3D elements.

• contour (int) –

  Flag that determines how the results are presented. Valid values are:

  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. Only required, if contour is 2.

Example

Test all displayed elements for a cell squish of 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.elementtestcellsquish(
    collection=elems1,
    cell_squish=0.5,
    output_collection=elems2,
    dimension=0,
    contour=0,
    title=""
)