Model.elementtestvolumeareaskew

Model.elementtestvolumeareaskew(collection, skew, output_collection, dimension, contour, title)

Tests 2D and 3D elements using the volumetric and areal element quality check. The 3D volumetric skew corresponds directly to the Abaqus and Fluent CFD tetra element quality checks.

Parameters:

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

• skew (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 to measure the dimension of:

  2 - Measure 2D elements.

  4 - Measure 3D elements.

• contour (int) –

  A 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.

Examples

Testing all displayed tetra elements for a volumetric skew of 0.6

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.elementtestvolumeareaskew(
    collection=elems1,
    skew=0.6,
    output_collection=elems2,
    dimension=4,
    contour=0,
    title=""
)

Testing all displayed tria elements for an areal skew 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.elementtestvolumeareaskew(
    collection=elems1,
    skew=0.5,
    output_collection=elems2,
    dimension=2,
    contour=0,
    title=""
)