Model.elementtestinterangle

Model.elementtestinterangle(collection, testangle, trias, outputcollection, wantmin, dimension, contour, title)

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

Parameters:

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

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

• trias (int) – A nonzero value indicates to test trias or tria faces, as opposed to quads or quad faces.

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

• wantmin (int) – A nonzero value indicates to check if the element’s smallest angle is less than the threshold, as opposed to its largest angle being greater than the threshold.

• dimension (int) –

  A code telling to measure the dimension of:

  1 - Measure 1D elements.

  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

Test all displayed elements for an interior angle value less than 135.0

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.elementtestinterangle(
        collection=elems1,
        testangle=135.0,
        trias=0,
        outputcollection=elems2,
        wantmin=0,
        dimension=2,
        contour=0,
        title="Quad Max Angle"
)

Note

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