*elementtestaspect

Tests 2D and 3D elements using the aspect element quality check.

Syntax

*elementtestaspect entity_type mark_id aspect output_mark_id dimension contour title

Type

HyperMesh Tcl Modify Command

Description

Tests 2D and 3D elements using the aspect element quality check.

Inputs

entity_type
The entity types to be checked. Only elements are supported.
mark_id
The mark ID containing the elements to test. Valid values are 1 and 2.
aspect
The value to use as a threshold beyond which elements should be considered to have failed the test.
dimension
The option of whether to measure 2D or 3D elements:
  • 2 - Measure 2D elements.
  • 4 - Measure 3D elements.
output_mark_id
The mark ID where the failed elements will be placed. Valid values are 1 and 2.
contour
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
The title to label the curve in the histogram. Only required, if contour is 2.

Example

To test all displayed 3D elements for an aspect of 5.0:
*createmark elems 1 "displayed"
*elementtestaspect elems 1 5.0 0 4 0 ""
To test all displayed 2D elements for an aspect of 6.0:
*createmark elems 1 "displayed"
*elementtestaspect elems 1 6.0 0 2 0 ""

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}