Model.elementtestskew

Model.elementtestskew(collection, skewangle, outputcollection, dimension, contour, title)

Tests 2D and 3D elements for whether or not they pass the skew element quality check, and puts those that fail on the specified outputcollection.

Parameters:

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

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

• outputcollection (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) –

  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 skew value less than 60

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.elementtestskew(
    collection=elems1,
    skewangle=60,
    outputcollection=elems2,
    dimension=2,
    contour=0,
    title="2D Element Skew"
)

Note

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