*elementtestlength

Tests elements for whether or not they pass the edge length element quality check, and puts those that fail on the specified outputmark.

Syntax

*elementtestlength entities markmask length outputmark wantmin dimension contour title

Type

HyperMesh Tcl Modify Command

Description

Tests elements for whether or not they pass the edge length element quality check, and puts those that fail on the specified outputmark.

Inputs

entities
The entity types to be checked. Currently, elements is supported.
markmask
The mark that contains the elements to test.
length
The value to use as a threshold beyond which elements should be considered to have failed the test.
outputmark
The mark where HyperMesh should put the elements that fail the test.
wantmin
A nonzero value indicates to check if the element's smallest edge is less than the threshold, as opposed to its largest edge being greater than the threshold.
dimension
A code telling to measure the dimension of:
  • 1 - Measure 1D elements.
  • 2 - Measure 2D elements.
  • 4 - Measure 3D elements.
contour
A code telling if HyperMesh should:
  • 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.

Example

*createmark(elements,1) "all"
*createmark(elements,2)
*elementtestlength(elements,1,20,2,1,2,0,"2D Element Length")

With 2D and 3D elements, the only concern is if the element is too small.

With 1D elements, there is an additional test available to test if the element is too large. To activate that test, set dimension to 1 and wantmin to 1.

The details of the edge length element quality check can be found in the online help for the Check Elements panel.