Face Queries

This section contains reference material on the available tag names and corresponding type for all face-based query diagnostics.

Note The same limitations and conditions apply to using face-based queries in macros as with using the GUI. See Face Query Tools for more information.

Face Area

Tag Name Type Description

FaceId

Int

Face ID of the selected face

TotalFaceArea

Double

Total area of all selected faces

MinArea

Double

Minimum area of all selected faces

MaxArea

Double

Maximum area of all selected faces

AveArea

Double

Average area of all selected faces

AreaUnits

ClientServerObject<Units>

Preferred area units for the query

Face Centroid

Tag Name Type Description

FaceId

Int

Face ID of the selected face

FaceCentroid

Vector<Double>

Face centroid coordinates

LengthUnits

ClientServerObject<Units>

Preferred length units for the query

Face Normal

Tag Name Type Description

FaceId

Int

Face ID of the selected face

FaceNormal

Vector<Double>

Face normal vector in preferred units

NormalizedFaceNormal

Vector<Double>

Normalized face normal vector

NormalUnits

ClientServerObject<Units>

Preferred length units specified for query

Face Quality

Tag Name Type Description

FaceId

Int

Face ID of the selected face

FaceQuality

Double

Face quality of the selected face

MinQuality

Double

Minimum face quality of all selected faces

MaxQuality

Double

Maximum face quality of all selected faces

AveQuality

Double

Average face quality of all selected faces

Face Geometric Range

Tag Name Type Description

LabMinRange

Vector<Double>

Minimum range relative to the laboratory coordinate system

LabMaxRange

Vector<Double>

Maximum range relative to the laboratory coordinate system

XYZComponents

Vector<Double>

X, Y, and Z components of range from minimum to maximum

LengthUnits

ClientServerObject<Units>

Preferred length units for the query

Part Surface List

Tag Name Type Description

SelectedPartSurfaces

ClientServerObject<PartSurface>

Part surfaces to which the selected faces belong

SelectedPartSurfacesFaceCount

Vector<Int>

Number of selected faces that belong to a part surface

SelectedContactSurfaces

ClientServerObject<PartSurface>

Contact part surfaces to which the selected faces belong

SelectedContactFaceCount

Vector<Int>

Number of selected faces that belong to a contact part surface

Region Boundary List

Tag Name Type Description

SelectedBoundarySurfaces

ClientServerObject<Boundary>

Boundaries to which the selected faces belong

SelectedBoundaryFaceCount

Vector<Int>

Number of selected faces that belong to the boundaries

SelectedInterfaceSurfaces

ClientServerObject<Boundary>

Interfaces to which the selected faces belong

SelectedInterfaceFaceCount

Vector<Int>

Number of selected faces that belong to an interface

Selection Volume

Tag Name Type Description

FaceVolume

Double

Volume of the face selection set

VolumeUnits

ClientServerObject<Units>

The preferred units used for the volume result

ClosedAndManifold

Boolean

True if the selection set is closed and manifold, else false