hm_getelemchecksummary3d

Returns the 3D solid element quality summary.

Syntax

hm_getelemchecksummary3d mark_id options

Type

HyperMesh Tcl Query Command

Description

This command returns the element quality summary for the selected 3D elements. The return values are grouped into 3 parts:
  1. The number of counted elements.
  2. The number elements that failed passing the selected measurement(s).
  3. A summary of the selected quality measurements. For every quality measurement, it includes three items:
    • The name of the quality measurement.
    • The number of elements that failed passing this measurement.
    • The quality value of the worst element using this measurement.

Inputs

mark_id
The ID of the mark containing the elements to query.
option
This parameter constructs a table of quality measurements that are used to determine the summary. Each measurement includes the measurement name, failed value and solver ID (currently only HyperMesh solver ID = 0 is supported). Valid quality measurements include:
aspect_ratio
cell_squish
equi_skew
jacobian
max_interior_angle
min_interior_angle
ortho_3d
size_ratio_3d
skew
tet_collapse
vol_ar
vol_skew
warpage

For every item, you can chose to only input the name and some values; in this case, the remainder will use the default values.

Example

To count the displayed elements with tet_collapse ≤ 0.01 and vol_skew ≥ 0.90:
*createmark elems 1 displayed
set table "tet_collapse 0.01 vol_skew 0.90"
set elem_sum [hm_getelemchecksummary3d 1 $table]

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 option strings ortho_3d and size_ratio_3d.