*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.
- 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.
- 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.