hm_getelemcheckvalues

Returns the check value for elements from within a selection.

Syntax

hm_getelemcheckvalues mark_id dimension check_type ?time_failure?

Type

HyperMesh Tcl Query Command

Description

This command returns a single list containing alternating values of element IDs and the corresponding check value for that element. Only the elements on mark_id and of the specified dimension are considered when determining which elements and values are returned.

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 length value for all 1D elements in comp1:

*createmark elems 1 "by collector name" comp1
set elemvals [hm_getelemcheckvalues 1 1 length]

To get the warpage value for all displayed 2D elements:

*createmark elems 1 displayed
set elemvals [hm_getelemcheckvalues 1 2 warpage]

To get the jacobian of all 3D elements:

*createmark elems 1 all
set elemvals [hm_getelemcheckvalues 1 3 jacobian]

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.