hm_getelemcheckbounds

Returns the lower and upper bound values of the specified element check from the selected elements.

Syntax

hm_getelemcheckbounds mark_id dimension check_type ?time_failure?

Type

HyperMesh Tcl Query

Description

This command returns the lower bound and upper bound values of the specified element check from the selected elements. Only the elements on mark_id and of the specified dimension are considered when calculating the lower and upper bound values.

Inputs

mark_id

The ID of the mark containing the elements. Valid values are 1 and 2.

dimension

The dimension of the elements on mark_id to consider. Valid values are:

1 – 1D elements

2 – 2D elements

3 – 3D elements

If no elements of the specified dimension are on mark_id, an error is returned.

check_type

The type of element check to return the bounds from. The allowable values depend on the dimension specified:

dimension = 1:

length
timestep

dimension = 2:

addedmass
aspect
cellsquish
chordaldev
equiskew
jacobian
length
maxinterangle
maxlength
mininterangle
minlength
skew
taper
timestep
volumeareaskew
warpage

dimension = 3:

addedmass
altitudeaspect
aspect
cellsquish
equiskew
jacobian
length
maxinterangle
maxlength
mininterangle
minlength
ortho_3d
size_ratio_3d
skew
tetracollapse
timestep
volumeareaskew
volumetricskew
warpage

?time_failure?

The value to use as a threshold beyond which the input elements should be considered to have failed the test. This is required only when check_type is set to addedmass.

Examples

To get the min and max length of all displayed 1D bar elements:

*createmark elems 1 "by config" bar
*createmark elems 2 displayed
*markintersection elems 1 elems 2
foreach {lower upper} {[hm_getelemcheckbounds 1 1 length]} {}

To get the lower and upper length values for all first order 2D elements:

*createmark elems 1 "by config" tria3 quad4
foreach {lower upper} {[hm_getelemcheckbounds 1 2 length]} {}

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:

if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

10.0

2019 - Added new check_type values minlength and maxlength for both 2D and 3D, and ortho_3d and size_ratio_3d for 3D.