Cell Quality Tool

From XMS Wiki
This is the approved revision of this page, as well as being the most recent.
Jump to navigationJump to search


Cell Quality

The Cell Quality tool creates a new 2D mesh with datasets that represent the quality of the triangles and quadrilaterals of input UGrid. General polygons are not supported.

The qualities compare triangles to equilateral triangles, and quadrilaterals to squares – comparing angles, length ratios, and areas to the "ideal". The qualities calculated are:

  • Alpha Min: the ratio of the smallest angle to the "ideal" angle (60 degrees for triangles, 90 degrees for quadrilaterals)
  • Lmax/Lmin: the ratio of the largest leg length to the smallest
  • ALS: the ratio of the idealized area to the squared lengths of the sides
  • Rr: The ratio of the outer radius R to the inner radius r
  • Lr: The ratio of the longest leg L to the inner radius r
  • Lh: The ratio of the longest leg L to the shortest height h (for triangles) or the largest diagonal to the smallest diagonal (for quadrilaterals)

Input Parameters

  • 2D UGrid – Select the input UGrid to to calculate the quality of the cells
  • Alpha Min dataset name (optional, default "q_alpha_min") – the name for the output dataset for Alpha Min
  • Lmax/Lmin dataset name (optional, default "q_Ll") – the name for the output dataset for Lmin Lmax
  • ALS dataset name (optional, default "q_ALS") – the name for the output dataset for ALS
  • Outer/Inner Radius Ratio dataset name (optional, default "q_Rr") – the name for the output dataset for Rr
  • Lmax/Inner Radius Ratio dataset name (optional, default "q_Lr") – the name for the output dataset for Lr
  • Hmin/Lmax Ratio dataset name (optional, default "q_Lh") – the name for the output dataset for Lh

If any of the optional parameters for dataset names are left blank, those datasets will not be calculated; for example, if only wanting Alpha Min, ALS, and Lh, only provide provide names "my_alpha_min", "my_ALS", and "my_Lh", and leave the others blank – and the 'Output UGrid will have the datasets "my_alpha_min", "my_ALS", and "my_Lh" attached.

For any measurement, if a particular cell is invalid for that measurement, it will have a value of "-888.0" (Unsupported Geometry) or "-999.0" (Undefined quality value). Each dataset will have an "Active" array that is "1" if the cell has a valid measurement value, and "0" otherwise.

Output parameters

  • UGrid name – Enter the name of the new mesh.

Current location in Toolbox

Unstructured Grid/Cell Quality