*getqualitysummary

Computes the quality index for the specified selection of shell elements and writes the quality summary to the specified text file.

Syntax

*getqualitysummary elementmark summary_file failedmark criteria_use_mode

Type

HyperMesh Tcl Modify

Description

Computes the quality index for the specified selection of shell elements and writes the quality summary to the specified text file. Optionally places the failed elements to the specified mark.

Inputs

elementmark
The mark of elements to be evaluated.
Does not need to be a contiguous block. Must be 1 or 2.
summary_file
The path to the quality summary destination file (a quoted string).
failedmark
The mark for failed elements. It must be 0, 1, or 2, and different from elementmark.
0 - Failed elements are not marked.
criteria_use_model
The mode for using and controlling the quality criteria. It must be one of the following:
  • 0 - The computation is performed regardless of whether or not the quality criteria was previously set using one of the following commands: *reset_qa_calculator(), *readqualitycriteria(), *reset_qa_calculator_from_file(), *set_default_quality_criteria(). If the criteria is not specified, the default criteria, adjusted to the selection element size, is set as current.
  • 1 - The computation requires the quality criteria to be pre-set using one of the commands listed above. An error is returned, if the quality criteria does not exist. If the criteria exists, the computation is performed regardless. This is the most common value for this parameter.
  • 2 - The computation requires the quality criteria to be pre-set. An error is returned, if the quality criteria does not exist. If the criteria exists, the command checks to see if the size criteria matches the selection element size and returns an error, if there is a mismatch.
  • 3 - The computation requires the quality criteria to be pre-set. An error is returned, if the quality criteria does not exist. If the criteria exists, the command checks to see if the size criteria matches the selection element size, adjusts the size criteria to the selection element size, and performs the computation.

Example

To evaluate elements 100 through 110 using the quality criteria file, c:/mycriteria/durability.txt, to write the quality summary to c:/myres/dur_sum.txt and to mark the failed elements:
*readqualitycriteria("c:/mycriteria/durability.txt")
*createmark(elements,1) 100 101 102 103 104 105 106 107 108 109 110
*getqualitysummary(1, "c:/myres/dur_sum.txt",2,1)
The example above using the default criteria if the criteria were not set before using any of the corresponding commands:
*createmark(elements,1) 100 101 102 103 104 105 106 107  108 109 110
*getqualitysummary(1,"c:/myres/dur_sum.txt",2,0)

A *createmark() directive is required for this command.

For batch mode, the command should be preceeded by an hm_answernext "yes" or hm_answernext "no" command to provide instructions for writing to an existing file.