Model.elementtesttimestep

Model.elementtesttimestep(collection, time_beam, time_spring, time_shell, time_solid, time_tshell, output_collection, dimension, contour, added_mass, title)

Tests beam, spring, shell, solid and thick shell elements using the time step element quality check.

Parameters:

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

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

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

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

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

• time_tshell (double) – The value to use as a threshold beyond which thick shell 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:

  1 - Measure 1D (beam and spring) elements only.

  2 - Measure 2D (shell) elements only.

  4 - Measure 3D (solid) elements only.

  6 - Measure 2D (shell) and 3D (solid) elements.

  7 - Measure all 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.

• added_mass (int) –

  A flag indicating what to contour.

  0 - Time step

  1 - Added mass, when contour is set to 1.

• title (hwString) – The title for the contour, when contour is set to 1.

Examples

Testing all displayed shell elements for a time step of 0.0001

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.elementtesttimestep(
        collection=elems1,
        time_beam=0,
        time_spring=0,
        time_shell=0.0001,
        time_solid=0,
        time_tshell=0,
        output_collection=elems2,
        dimension=2,
        contour=0,
        added_mass=0,
        title=""
)

Testing all displayed shell and solid elements for a time step of 0.0001 and display a contour

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.elementtesttimestep(
        collection=elems1,
        time_beam=0,
        time_spring=0,
        time_shell=0.0001,
        time_solid=0,
        time_tshell=0,
        output_collection=elems2,
        dimension=6,
        contour=1,
        added_mass=0,
        title=""
)