*elementtesttimestep

Tests beam, spring, shell, solid and thick shell elements using the time step element quality check.

Syntax

*elementtesttimestep entity_type mark_id time_beam time_spring time_shell time_solid time_tshell output_mark_id dimension contour added_mass title

Type

HyperMesh Tcl Modify Command

Description

Tests beam, spring, shell, solid and thick shell elements using the time step 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.
time_beam
The value to use as a threshold beyond which beam elements should be considered to have failed the test.
time_spring
The value to use as a threshold beyond which spring elements should be considered to have failed the test.
time_shell
The value to use as a threshold beyond which shell elements should be considered to have failed the test.
time_solid
The value to use as a threshold beyond which solid elements should be considered to have failed the test.
time_tshell
The value to use as a threshold beyond which thick shell elements should be considered to have failed the test.
dimension
A code to measure the dimension of:
  • 1 - Measure 1D (beam and spring) elements only.
  • 2 - Measure 2D (shell) elements only.
  • 4 - Measure 3D (solid) elements only.
  • 6 - Measure 2D (shell) and 3D (solid) elements.
  • 7 - Measure all 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.
added_mass
A flag indicating what to contour.
  • 0 - Time step
  • 1 - Added mass, when contour is set to 1.
title
The title for the contour, when contour is set to 1.

Examples

To test all displayed shell elements for a time step of 0.0001:
*createmark elems 1 "displayed"
*elementtesttimestep elems 1 0 0 0.0001 0 0 2 1 0 0 ""
To test all displayed shell and solid elements for a time step of 0.0001 and display a contour:
*createmark elems 1 "displayed"
*elementtesttimestep elems 1 0 0 0.0001 0 0 6 1 1 0 ""

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

12.0.110