pw::Face

A face is part of a block boundary, consisting of oriented, edge-connected pw::Domain objects.

Derives From

pw::Object

Summary
pw::FaceA face is part of a block boundary, consisting of oriented, edge-connected pw::Domain objects.
StaticActions
getSurfaceEdgeMinimumLengthThis action gets the calculated minimum surface edge length based on area of cells in all given faces.
getSurfaceEdgeMaximumLengthThis action gets the calculated maximum surface edge length based on area of cells in all given faces.
Instance Actions
deleteThis action deletes the face.
getStateThis action gets the state of this face.
getDimensionsThis action gets the dimensions of this face.
getPointCountThis action gets the number of points in this face.
getPointThis action gets the position of a face grid point.
getPositionThis action gets the position in the defining space of the face at the given index.
getXYZThis action gets the position of the domain in model space at the given index.
getCellCountThis action gets the number of cells in this face.
getCellThis action gets the indices of the given cell.
getLinkagesThis action gets the possible ways a domain can be added to a face.
getDomainCountThis action gets the number of domains in this face.
getDomainThis action gets a domain from this face.
addDomainThis action adds a domain to this face.
removeLastDomainThis action removes the last domain added to this face.
findDomainThis action finds the given domain in this face’s domain list.
getDomainOrientationThis action gets the orientation of a domain in this face.
getEdgeCountThis action gets the number of edges in this face.
getEdgeThis action gets an edge from this face.
getEdgesThis action gets all edges from this face.
findEdgeThis action finds the given edge in this face’s edge list.
joinDomainsThis action joins the domains in this face to create a single domain.
getDomainsThis action gets all domains in a face.
mapLinkageThis action maps a domain linkage to the face edges.

StaticActions

getSurfaceEdgeMinimumLength

pw::Face getSurfaceEdgeMinimumLength faces

This action gets the calculated minimum surface edge length based on area of cells in all given faces.

Parameters

facesThis required parameter is a list of pw::Face.

Returns

This action returns the float minimum surface edge length.

getSurfaceEdgeMaximumLength

pw::Face getSurfaceEdgeMaximumLength faces

This action gets the calculated maximum surface edge length based on area of cells in all given faces.

Parameters

facesThis required parameter is a list of pw::Face

Returns

This action returns the float maximum surface edge length.

Instance Actions

delete

$face delete

This action deletes the face.  This can only be done if the face has not been added to a pw::Block.  Calling delete on a face after it has been added to a block will generate an error.

Parameters

none

Returns

This action returns nothing.

getState

$face getState

This action gets the state of this face.

Parameters

none

Returns

This action returns a string with options < Complete | Incomplete | Invalid >.

getDimensions

$face getDimensions

This action gets the dimensions of this face.

Parameters

none

Returns

This action returns a two integer element list of the dimensions of the face.  Unstructured faces have a second dimension of 1.

getPointCount

$face getPointCount

This action gets the number of points in this face.

Parameters

none

Returns

This action returns the integer number of points.

getPoint

$face getPoint index

This action gets the position of a face grid point.

Parameters

indexThis required parameter is the integer index of the grid point to get with the range [1, number of points].

Returns

This action returns a point giving the grid point position (may be in the form “u v dbentity”).

getPosition

$face getPosition ?-index? value

This action gets the position in the defining space of the face at the given index.

Parameters

-indexThis optional flag indicates to get the position at a grid point.  The value is an integer index in the range [1, number of points].  This is the default option.
valueThis required parameter is the value at which to get the position.

Returns

This action returns a point giving the position on the face, which may be in the form “u v dbentity”.

getXYZ

$face getXYZ ?-index? value

This action gets the position of the domain in model space at the given index.

Parameters

-indexThis optional flag indicates to get the position at a grid point.  The value is an integer index in the range [1, number of points].  This is the default option.
valueThis required parameter is the value at which to get the position.

Returns

This action returns an XYZ vector.

getCellCount

$face getCellCount

This action gets the number of cells in this face.

Parameters

none

Returns

This action returns the integer number of cells.

getCell

$face getCell index

This action gets the indices of the given cell.

Parameters

indexThis required parameter is the index of the cell to get in the range [1, number of cells].

Returns

This action returns a list of indices.

getLinkages

$face getLinkages domain

This action gets the possible ways a domain can be added to a face.

Parameters

domainThis required parameter is the pw::Domain object to be checked.

Returns

This action returns a list of linkages, with each linkage entry consisting of, in order:

  • the starting domain edge integer index
  • the connector integer index of the starting edge
  • the ending domain edge integer index
  • the connector integer index of the ending edge
  • the starting face edge integer index
  • the connector integer index of the starting face edge
  • a boolean value specifying whether or not the orientation is reversed.

getDomainCount

$face getDomainCount

This action gets the number of domains in this face.

Parameters

none

Returns

This action returns the integer number of domains.

getDomain

$face getDomain index

This action gets a domain from this face.

Parameters

indexThis required parameter is the integer index of the domain to get in the range [1, number of domains].

Returns

This action returns a pw::Domain object.

addDomain

$face addDomain ?-linkage linkage? domain

This action adds a domain to this face.

Parameters

-linkage linkageThis optional parameter is the linkage to use when adding.  The default is the first found.
domainThis required parameter is the pw::Domain object to add.

See Also

getLinkages, mapLinkage

Returns

This action returns nothing.

removeLastDomain

$face removeLastDomain

This action removes the last domain added to this face.

Parameters

none

Returns

This action returns nothing.

findDomain

$face findDomain domain

This action finds the given domain in this face’s domain list.

Parameters

domainThis required parameter is the pw::Domain object to locate.

Returns

This action returns the integer index of the domain in the domain list, or 0 if the domain was not found.

getDomainOrientation

$face getDomainOrientation index

This action gets the orientation of a domain in this face.

Parameters

indexThis required parameter is the integer index of the domain of which to get the orientation in the range [1, number of domains].

Returns

This action returns a string with options < Same | Opposite >.

getEdgeCount

$face getEdgeCount

This action gets the number of edges in this face.

Parameters

none

Returns

This action returns the integer number of edges.

getEdge

$face getEdge index

This action gets an edge from this face.

Parameters

indexThis required parameter is the integer index of the edge to get in the range [1, number of edges].

Returns

This action returns a pw::Edge object.

getEdges

$face getEdges

This action gets all edges from this face.

Parameters

This action has no parameters.

Returns

This action returns a pw::Edge object list.

findEdge

$face findEdge edge

This action finds the given edge in this face’s edge list.

Parameters

edgeThis required parameter is the pw::Edge object to locate.

Returns

This action returns the integer index of the edge in the edge list, or 0 if the edge was not found.

joinDomains

$face joinDomains

This action joins the domains in this face to create a single domain.

Parameters

none

Returns

This action returns a new pw::DomainStructured or pw::DomainUnstructured object.

getDomains

$face getDomains

This action gets all domains in a face.

Parameters

none

Returns

This action returns a list of pw::Domain in the face (each domain is only listed once, regardless of the number of times it is used by the face).

mapLinkage

$face mapLinkage linkage domain

This action maps a domain linkage to the face edges.

Parameters

linkageThis required parameter is the linkage array returned by the getLinkages function.
domainThis required parameter is the pw::Domain for which the linkage is valid.

Returns

This action returns a list of 4 integers values representing in order:

  • the edge integer index of the start of the linkage
  • the connector integer index of the start of the linkage
  • the edge integer index of the end of the linkage
  • the connector integer index of the end of the linkage

The start and end are arranged so that the edge and connector indices increase as you proceed from the start to the end.  Note that for an unstructured face, the will be constrained to a single edge.  This means that if the start connector index is higher than the end connector index, the linkage wraps around on the same edge.

A domain is a computationally two-dimensional grid entity, bounded by one or more pw::Edges.
pw::Face getSurfaceEdgeMinimumLength faces
This action gets the calculated minimum surface edge length based on area of cells in all given faces.
pw::Face getSurfaceEdgeMaximumLength faces
This action gets the calculated maximum surface edge length based on area of cells in all given faces.
$face delete
This action deletes the face.
$face getState
This action gets the state of this face.
$face getDimensions
This action gets the dimensions of this face.
$face getPointCount
This action gets the number of points in this face.
$face getPoint index
This action gets the position of a face grid point.
$face getPosition ?-index? value
This action gets the position in the defining space of the face at the given index.
$face getXYZ ?-index? value
This action gets the position of the domain in model space at the given index.
$face getCellCount
This action gets the number of cells in this face.
$face getCell index
This action gets the indices of the given cell.
$face getLinkages domain
This action gets the possible ways a domain can be added to a face.
$face getDomainCount
This action gets the number of domains in this face.
$face getDomain index
This action gets a domain from this face.
$face addDomain ?-linkage linkage? domain
This action adds a domain to this face.
$face removeLastDomain
This action removes the last domain added to this face.
$face findDomain domain
This action finds the given domain in this face’s domain list.
$face getDomainOrientation index
This action gets the orientation of a domain in this face.
$face getEdgeCount
This action gets the number of edges in this face.
$face getEdge index
This action gets an edge from this face.
$face getEdges
This action gets all edges from this face.
$face findEdge edge
This action finds the given edge in this face’s edge list.
$face joinDomains
This action joins the domains in this face to create a single domain.
$face getDomains
This action gets all domains in a face.
$face mapLinkage linkage domain
This action maps a domain linkage to the face edges.
Base type for all glyph types
A face is part of a block boundary, consisting of oriented, edge-connected pw::Domain objects.
A float is a fractional number.
A block is a volume grid bounded by one or more pw::Faces.
A string is an array of characters.
An integer is a whole number.
A point is a position either in model space or database parameter space.
A vector is a list of float values.
An index is a list of integer values.
A boolean is represented as a 0 or 1, with 0 being false and 1 being true.
An edge is part of a domain boundary, consisting of oriented, node-connected pw::Connector objects.
A structured domain is a computationally orthogonal surface grid bounded by exactly four edges, any of which can be degenerate in the zero dimension (pole).
An unstructured domain is a watertight collection of edge-connected surface elements (triangle, quadrilateral, etc.)
Close