Examine type
pw:: | Examine type |
Static Actions | |
create | This action creates an examine object. |
getFunctionNames | This action gets a list of allowable function names. |
addSavedCut | This action adds a cut to the list of saved cuts for block examine. |
removeSavedCut | This action removes a cut from the list of saved cuts for block examine. |
getSavedCutCount | This action gets the number of saved cuts for block examine. |
getSavedCut | This action gets the specified saved cut for block examine. |
domainArea | This action reports statistics about the cell area of domains. |
domainSkewMinimum | This action reports statistics about the minimum skew of domains. |
domainSkewMaximum | This action reports statistics about the maximum skew of domains. |
domainSkewAngle | This action reports statistics about the skew angle of domains. |
domainCentroidX | This action reports statistics about the centroid X coordinate of domains. |
domainCentroidY | This action reports statistics about the centroid Y coordinate of domains. |
domainCentroidZ | This action reports statistics about the centroid Z coordinate of domains. |
blockVolume | This action reports statistics about the cell volume of blocks. |
blockSkewMinimum | This action reports statistics about the cell minimum skew of blocks. |
blockSkewMaximum | This action reports statistics about the cell maximum skew of blocks. |
blockSkewAngle | This action reports statistics about the cell skew angle of blocks. |
blockCentroidX | This action reports statistics about the cell centroid X coordinate of blocks. |
blockCentroidY | This action reports statistics about the cell centroid Y coordinate of blocks. |
blockCentroidZ | This action reports statistics about the cell centroid Z coordinate of blocks. |
blockJacobian | This action reports statistics about the blocks’ Jacobians. |
Instance Actions | |
delete | This action deletes this examine object. |
clear | This action clears any computed data. |
examine | This action executes the examine function for each entity added to the examine object. |
refilter | This action processes the computed examine data again with any modified values in the interval count or range limits without recalculating the examine functions on each entity. |
getAverage | This action gets the average value computed during the last call to examine. |
getMaximum | This action gets the maximum value computed during the last call to examine. |
getMinimum | This action gets the minimum value computed during the last call to examine. |
getEntityCount | This action gets the number of entities being examined and optionally sets a variable to the list of entities. |
getEntities | This action the list of entities being examined. |
addEntity | This action adds one or more entities to the examine object. |
removeEntity | This action removes one or more entities from the examine object. |
removeAll | This action removes all entities from the examine object. |
getRangeLimits | This action returns the lower and upper cutoff limits. |
setRangeLimits | This action sets the lower and upper cutoff limits to be applied during the next call to examine or refilter. |
getBelowRange | This action gets the number of cells or points that were below the lower cutoff range during the last examine or refilter call. |
getInRange | This action gets the number of cells or points between the lower and upper cutoff limits (inclusive) during the last examine or refilter call. |
getAboveRange | This action gets the number of cells or points that were above the upper cutoff range during the last examine call. |
getIntervalCount | This action gets the number of intervals used for the histogram when examine or refilter was last run. |
setIntervalCount | This action sets the number of intervals to use for the histogram. |
getIntervalLimits | This action gets the limits of all intervals in the histogram. |
getIntervalTotal | This action gets the number of values in the specified interval. |
getIntervalTotals | This action gets the number of values in all intervals. |
getValue | This action gets the computed value at a location within an entity. |
getValues | This action gets the list of computed values within an entity. |
getValueAtPoint | This action gets the computed value at a grid point location within an entity. |
getValueCount | This action gets the number of computed values either for a specific entity or for all entities. |
getXYZ | This action gets the sample point at a location within an entity. |
getStencil | This action gets the grid or database coordinates for the examined element of an entity at a given point or cell index depending upon whether grid or database entities are being examined. |
getStencilXYZs | This action gets the XYZ values for the examined element of an entity at a given point or cell index. |
getCategories | This action gets the list of categories for which separate counts are maintained. |
getCategoryCount | This action gets the specified category count for the examine function. |
setCurrentHighlighterPosition | This action gets the constant U and V lines for the examined entity at a given point. |
getCurrentHighlighterPosition | This action gets the value of the current highlighter position. |
pw::Examine create type
This action creates an examine object.
type | This parameter is a function name string of the type of examination to create: BlockAspectRatio | BlockCellIndexI | BlockCellIndexJ | BlockCellIndexK | BlockCellType | BlockCentroidX | BlockCentroidY | BlockCentroidZ | BlockComponentVolume | BlockDonorVolRatio | BlockEdgeLength | BlockJacobian | BlockLengthI | BlockLengthJ | BlockLengthK | BlockLengthRatioI | BlockLengthRatioJ | BlockLengthRatioK | BlockMaximumAngle | BlockMinimumAngle | BlockNone | BlockFidelityExpansionRatio | BlockFidelitySkewEquiangle | BlockFidelityVolumeRatio | BlockPointIndexI | BlockPointIndexJ | BlockPointIndexK | BlockSkewCentroid | BlockSkewEquiangle | BlockSkewEquivolume | BlockSmoothnessI | BlockSmoothnessJ | BlockSmoothnessK | BlockVertexCenteredExpansionFactor | BlockVertexCenteredOrthogonality | BlockVertexCenteredVolume | BlockVolume | BlockVolumeRatio | ConnectorEdgeLength | ConnectorLengthI | ConnectorLengthRatioI | ConnectorOnDatabase | ConnectorOnDatabaseSources | ConnectorSmoothnessI | DatabaseEdgeTolerance | DatabaseProximityBoundary | DatabaseProximitySurface | DomainArea | DomainAreaRatio | DomainAspectRatio | DomainCellIntersection | DomainCellType | DomainDatabaseDeviation | DomainRelativeDeviation | DomainEdgeLength | DomainJacobian | DomainLengthI | DomainLengthJ | DomainLengthRatioI | DomainLengthRatioJ | DomainMaximumAngle | DomainMinimumAngle | DomainOnDatabase | DomainOnDatabaseSources | DomainSkewEquiangle | DomainSkewEquiarea | DomainSmoothnessI | DomainSmoothnessJ | DomainWarp | EdgeWallOrthogonality | EdgeWallSpacing | FaceWallOrthogonality | FaceWallSpacing | SizeField | SizeFieldGradient. |
This action returns a new pw::Examine object.
pw::Examine getFunctionNames
This action gets a list of allowable function names.
None
This action returns a list of strings representing the supported function names.
pw::Examine addSavedCut type value <block | form> ?-excludeCellTypes type_list? ?user_normal?
This action adds a cut to the list of saved cuts for block examine.
type | This parameter is the type of cut: either User, X, Y, Z, I, J, or K. |
value | This parameter is the value of the cut (float value for User, X, Y, or Z type cuts, integer value for I, J, or K type cuts). |
form | For User, X, Y, or Z type cuts, this optional parameter specifies the type of cut to make: either Cells, Flat, or Crinkle. |
block | For I, J, or K type cuts, this optional parameter specifies the pw::Block object to which the cut applies. |
-excludeCellTypes | specify a list of cell types to exclude. Currently, the supported values are “Tet”, “Pyramid”, “Prism”, and “Hex”. Excluded cells are not displayed in the cut but do not effect the examine metric. |
user_normal | If the type is User, this parameter should indicate the cutting plane normal as a vector of three float numbers. This parameter is required if the type is User, and must not be present for any other type. |
This action returns the integer cut index.
pw::Examine removeSavedCut type value <block | form> ?-excludeCellTypes type_list? ?user_normal?
This action removes a cut from the list of saved cuts for block examine.
type | This parameter is the type of cut: either User, X, Y, Z, I, J, or K. |
value | This parameter is the value of the cut (float value for User, X, Y, or Z type cuts, integer value for I, J, or K type cuts). |
form | For User, X, Y, or Z type cuts, this optional parameter specifies the type of cut to make: either Cells, Flat, or Crinkle. |
block | For I, J, or K type cuts, this optional parameter specifies the pw::Block object to which the cut applies. |
-excludeCellTypes | specify a list of cell types to exclude. Currently, the supported values are “Tet”, “Pyramid”, “Prism”, and “Hex”. Excluded cells are not displayed in the cut but do not effect the examine metric. |
user_normal | If the type is User, this parameter should indicate the cutting plane normal as a vector of three float numbers. This parameter is required if the type is User, and must not be present for any other type. |
This action returns a boolean, which is true if successful.
pw::Examine getSavedCutCount
This action gets the number of saved cuts for block examine.
None
This action returns the integer number of saved cuts.
pw::Examine getSavedCut index
This action gets the specified saved cut for block examine.
index | This parameter is the integer index of the saved cut; [0, number of saved cuts). |
This action returns the specified saved cut as a list of seven or eight values in the following order. The first value is the cut type (User, X, Y, Z, I, J, or K). The second value is the cut value. The third value is either the form (Cells, Flat, or Crinkle) for User, X, Y, and Z cuts, or the pw::Block object to which the cut applies for I, J, and K cuts. The fourth value is a list of string specifying cell types that are excluded from the cut (“Tet”, “Pyramid”, “Prism”, “Hex”). If the cut type is User, there will be an fifth value representing the normal vector of the cutting plane.
pw::Examine domainArea ?-intervals number? resultsVar domain_list
This action reports statistics about the cell area of domains.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
domain_list | This parameter is a list of pw::Domain objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine domainSkewMinimum ?-intervals number? resultsVar domain_list
This action reports statistics about the minimum skew of domains.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
domain_list | This parameter is a list of pw::Domain objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine domainSkewMaximum ?-intervals number? resultsVar domain_list
This action reports statistics about the maximum skew of domains.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
domain_list | This parameter is a list of pw::Domain objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine domainSkewAngle ?-intervals number? resultsVar domain_list
This action reports statistics about the skew angle of domains.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
domain_list | This parametere is a list of pw::Domain objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine domainCentroidX ?-intervals number? resultsVar domain_list
This action reports statistics about the centroid X coordinate of domains.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
domain_list | This parameter is a list of pw::Domain objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine domainCentroidY ?-intervals number? resultsVar domain_list
This action reports statistics about the centroid Y coordinate of domains.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
domain_list | This parameter is a list of pw::Domain objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine domainCentroidZ ?-intervals number? resultsVar domain_list
This action reports statistics about the centroid Z coordinate of domains.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
domain_list | This parameter is a list of pw::Domain objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine blockVolume ?-intervals number? resultsVar block_list
This action reports statistics about the cell volume of blocks.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
block_list | This parameter is a list of pw::Block objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine blockSkewMinimum ?-intervals number? resultsVar block_list
This action reports statistics about the cell minimum skew of blocks.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
block_list | This parameter is a list of pw::Block objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine blockSkewMaximum ?-intervals number? resultsVar block_list
This action reports statistics about the cell maximum skew of blocks.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
block_list | This parameter is a list of pw::Block objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine blockSkewAngle ?-intervals number? resultsVar block_list
This action reports statistics about the cell skew angle of blocks.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
block_list | This parameter is a list of pw::Block objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine blockCentroidX ?-intervals number? resultsVar block_list
This action reports statistics about the cell centroid X coordinate of blocks.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
block_list | This parameter is a list of pw::Block objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine blockCentroidY ?-intervals number? resultsVar block_list
This action reports statistics about the cell centroid Y coordinate of blocks.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
block_list | This parameter is a list of pw::Block objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine blockCentroidZ ?-intervals number? resultsVar block_list
This action reports statistics about the cell centroid Z coordinate of blocks.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
block_list | This parameter is a list of pw::Block objects. |
This action returns nothing. Results will be in the resultsVar array.
pw::Examine blockJacobian ?-intervals number? resultsVar block_list
This action reports statistics about the blocks’ Jacobians.
-intervals number | This optional parameter is the integer number of intervals in the histogram with the range [1, infinity). The default is 10. |
resultsVar | This parameter is the string name of an array in which to store the results. |
block_list | This parameter is a list of pw::Block objects. |
This action returns nothing. Results will be in the resultsVar array.
$examine examine ?-excludeCellTypes type_list?
This action executes the examine function for each entity added to the examine object.
-excludeCellTypes | specify a list of cell types to exclude. Currently, the supported values while examining blocks are “Tet”, “Pyramid”, “Prism”, and “Hex”. “Tri” and “Quad” are supported when examining domains. The excluded cells will still have values calculated, but they will not be factored into the minimum value, maximum value, average value, below range count, above range count, or interval total calculations. Note that only some examine functions honor this request. |
This action returns nothing.
$examine getAverage
This action gets the average value computed during the last call to examine.
None
This action returns the float average value.
$examine getMaximum ?-entity entVar? ?-location locVar?
This action gets the maximum value computed during the last call to examine.
-entity entVar | This optional parameter is a string variable name which will be assigned with the pw::Entity object which contains the maximum value. For metrics that perform calculations at the boundaries of database surfaces, this will be a boundary. For the DatabaseEdgeTolerance metric, it will be the boundary of an underlying pw::SurfaceTrim. |
-location locVar | This optional parameter is a string variable name which will be assigned with the location within the entity of the maximum value as a list of 1 to 3 indices depending on the entity type. |
This action returns the maximum value.
$examine getMinimum ?-entity entVar? ?-location locVar?
This action gets the minimum value computed during the last call to examine.
-entity entVar | This optional parameter is a string variable name which will be assigned with the pw::Entity object which contains the minimum value. For metrics that perform calculations at the boundaries of database surfaces, this will be a boundary. For the DatabaseEdgeTolerance metric, it will be the boundary of an underlying pw::SurfaceTrim. |
-location locVar | This optional parameter is a string variable name which will be assigned with the location within the entity of the minimum value as a list of 1 to 3 indices depending on the entity type. |
This action returns the minimum value.
$examine getEntityCount ?-entities entsVar?
This action gets the number of entities being examined and optionally sets a variable to the list of entities.
-entities entsVar | This optional parameter is a string variable name that will be assigned with a list of the pw::Entity objects being examined. |
This action returns the integer number of entities.
$examine addEntity entities
This action adds one or more entities to the examine object. If successful, the metric data is cleared.
entities | This parameter is a framework_entity object, or list of framework_entity objects to include in the size field. |
entities | This parameter is a list of pw::Entity objects. |
This action returns the integer total number of entities in the examine object.
$examine removeEntity entities
This action removes one or more entities from the examine object. The metric data will be cleared if the last entity is removed.
entities | This parameter is a list of pw::Entity objects. |
This action returns the integer total number of entities remaining in the examine object.
$examine getRangeLimits
This action returns the lower and upper cutoff limits.
None
When setting the range limits, they are only applied to the next examine call. This function will return the current range limits. If they were set since the last call to examine or refilter, these values will not correspond to the counts returned by the getAboveRange, getInRange, and getBelowRange functions. Those values will have been computed from the range limits that were active at the time the examine or refilter function was last called.
This action returns a list comprised of the lower and upper cutoff limits, in that order, with each value being either the float number or the text “None” if no limit was specified.
$examine setRangeLimits < None | lower > < None | upper >
This action sets the lower and upper cutoff limits to be applied during the next call to examine or refilter.
lower | This parameter is the float lower cutoff limit. |
upper | This parameter is the float upper cutoff limit (must be greater than or equal to lower if the lower limit was specified). |
This action returns nothing.
$examine getBelowRange
This action gets the number of cells or points that were below the lower cutoff range during the last examine or refilter call.
None
If the range limits are changed, the counts returned by this function will only be valid if examine or refilter is called after the limits are changed. Otherwise, it returns the values based on the limits that were active at the time of the last examine or refilter call.
This action returns the integer count of the cells or points below the lower cutoff limit that was active during the last examine or refilter call.
$examine getInRange
This action gets the number of cells or points between the lower and upper cutoff limits (inclusive) during the last examine or refilter call.
None
If the range limits are changed, the counts returned by this function will only be valid if examine or refilter is called after the limits are changed. Otherwise, it returns the values based on the limits that were active at the time of the last examine or refilter call.
This action returns the integer count of the cells or points between the lower and upper cutoff limits that were active during the last examine or refilter call.
$examine getAboveRange
This action gets the number of cells or points that were above the upper cutoff range during the last examine call.
None
If the range limits are changed, the counts returned by this function will only be valid if examine or refilter is called after the limits are changed. Otherwise, it returns the values based on the limits that were active at the time of the last examine or refilter call.
This action returns the integer count of cells or points above the upper cutoff limit that was active during the last examine or refilter call.
$examine getIntervalCount
This action gets the number of intervals used for the histogram when examine or refilter was last run.
None
This action returns the integer number of intervals used for the histogram during the last examine or refilter call.
$examine setIntervalCount count
This action sets the number of intervals to use for the histogram.
count | This parameter is the integer number of intervals in the range [0, infinity). A value of 0 turns off histogram reporting. |
This action returns nothing.
$examine getIntervalLimits
This action gets the limits of all intervals in the histogram.
None
If the range limits or interval counts are changed, the values returned by this function will only be valid if examine or refilter is called after the limits or interval counts are changed. Otherwise, it returns the values based on the specifications that were active at the time of the last examine or refilter call.
This action returns a list of float values representing the interval limits with the first value representing the lower cutoff range, the next value representing the boundary between the first and second interval, etc., up to the last value which represent the upper cutoff range.
$examine getIntervalTotal interval
This action gets the number of values in the specified interval.
interval | This parameter is the integer number of the interval to get the total of; [1, number of intervals]. |
If the range limits or interval counts are changed, the values returned by this function will only be valid if examine or refilter is called after the limits or interval counts are changed. Otherwise, it returns the values based on the specifications that were active at the time of the last examine or refilter call.
This action returns the integer number of values in the interval.
$examine getIntervalTotals
This action gets the number of values in all intervals.
None
If the range limits or interval counts are changed, the values returned by this function will only be valid if examine or refilter is called after the limits or interval counts are changed. Otherwise, it returns the values based on the specifications that were active at the time of the last examine or refilter call.
This action returns a list of integer number of values in each interval, starting with the lowest interval.
$examine getValue < entity | boundary > index
This action gets the computed value at a location within an entity.
entity | This parameter is the pw::Entity object to query. |
boundary | For the DatabaseProximityBoundary metric, this parameter is the boundary of a pw::Surface, pw::SurfaceTrim, pw::Quilt, or pw::Model to query. For the DatabaseEdgeTolerance metric, it is the boundary of a pw::SurfaceTrim object belonging to one of the entities being examined. |
index | This parameter is the point or cell index within the entity (will either be a 1-, 2-, or 3-integer value depending on the entity type). |
This action returns a float representing the computed value at that point or cell.
$examine getValues < entity | boundary >
This action gets the list of computed values within an entity.
entity | This parameter is the pw::Entity object to query. |
boundary | For the DatabaseProximityBoundary metric, this parameter is the boundary of a pw::Surface, pw::SurfaceTrim, pw::Quilt, or pw::Model to query. For the DatabaseEdgeTolerance metric, it is the boundary of a pw::SurfaceTrim object belonging to one of the entities being examined. |
This action returns a list of floats representing the computed values for an entity.
$examine getValueAtPoint entity index
This action gets the computed value at a grid point location within an entity. Values are interpolated to the point if the examine element type is cell based or edge based.
entity | This parameter is the pw::GridEntity object to query. |
index | This parameter is the point index within the entity (will either be a 1-, 2-, or 3-integer value depending on the entity type). |
This action returns a float representing the computed value at that point.
$examine getValueCount ?< entity | boundary >?
This action gets the number of computed values either for a specific entity or for all entities.
entity | This optional parameter is the pw::Entity object to query. |
boundary | For the DatabaseProximityBoundary metric, this optional parameter is the boundary of a pw::Surface, pw::SurfaceTrim, pw::Quilt, or pw::Model to query. For the DatabaseEdgeTolerance metric, it is the boundary of a pw::SurfaceTrim object belonging to one of the entities being examined. |
This action returns the integer count of computed values. If an entity or boundary is specified, the value is the number of computed values for just that entity. Otherwise, the value is the number of computed values for all examined entities.
$examine getXYZ < entity | boundary > index
This action gets the sample point at a location within an entity. Note that this maps indices to points and does not necessarily have a direct correlation to indices used for non-point-based metrics.
entity | This parameter is the pw::Entity object to query. |
boundary | For the DatabaseProximityBoundary metric, this parameter is the boundary of a pw::Surface, pw::SurfaceTrim, pw::Quilt, or pw::Model to query. For the DatabaseEdgeTolerance metric, it is the boundary of a pw::SurfaceTrim object belonging to one of the entities being examined. |
index | This parameter is the point index within the entity (will either be a 1-, 2-, or 3-integer value depending on the entity type and the metric type). |
This action returns an XYZ vector.
$examine getStencil ?-type typeVar? < entity | boundary > index
This action gets the grid or database coordinates for the examined element of an entity at a given point or cell index depending upon whether grid or database entities are being examined. The values are returned as a list of point lists, with each point list representing an element of the stencil. The number of values in each point list is interpreted according to the examine function type as returned by the -type flag. The type value can be: Point, Line, Area, or Volume, Wall, Voxel, UnsVoxel, ControlVolume, or Deviation. For Point, Voxel, and UnsVoxel types, all elements will be a single point. For Line types, all elements will be 2 points long. For Area and Deviation types, elements will be either 3 points long (a triangle) or 4 points long (a quadrangle defined in counter-clockwise order by the right-hand rule). For Volume types, elements will be either 4 points long (a tetrahedron), 5 points long (a pyramid with the base defined in counter-clockwise order as the first 4 points and the tip of the pyramid as the 5th point), 6 points long (prism with the first 3 points representing the base and the next 3 points representing the top in the same order as the bottom), or 8 points long (a hexahedron with one face represented in the first 4 points in counter-clockwise order and the next 4 points representing the opposite face in the same order). For Wall types, elements will be 1 or 2 points long. For Control Volume types, the first and only element in the list will be 1 point long (indicating the node for which the control volume was created).
-type typeVar | This optional parameter is a string variable name that will be assigned with the type of element used to measure the examine function. It will be Point, Line, Area, Volume, Wall, Voxel, UnsVoxel, ControlVolume, or Deviation. |
entity | This parameter is the pw::Entity object to query. |
boundary | For the DatabaseProximityBoundary metric, this parameter is the boundary of a pw::Surface, pw::SurfaceTrim, pw::Quilt, or pw::Model to query. For the DatabaseEdgeTolerance metric, it is the boundary of a pw::SurfaceTrim object belonging to one of the entities being examined. |
index | This parameter is the point or cell index within the entity. It will either be a 1-, 2-, or 3-integer value depending on the entity type. |
This action returns a list of coords.
$examine getStencilXYZs ?-type type_var? < entity | boundary > index
This action gets the XYZ values for the examined element of an entity at a given point or cell index. The values are returned as a list of point lists, with each point list representing an element of the stencil. The number of values in each point list is interpreted according to the examine function type as returned by the -type flag. The type value can be: Point, Line, Area, or Volume, Wall, Voxel, UnsVoxel, ControlVolume, or Deviation. For Point, Voxel, and UnsVoxel types, all elements will be a single point. For Line types, all elements will be 2 points long. For Area types, elements will be either 3 points long (a triangle) or 4 points long (a quadrangle, defined in counter-clockwise order by the right-hand rule). For Volume types, elements will be either 4 points long (a tetrahedron), 5 points long (a pyramid with the base defined in counter-clockwise order as the first 4 points and the tip of the pyramid as the 5th point), 6 points long (prism with the first 3 points representing the base and the next 3 points representing the top in the same order as the bottom), or 8 points long (a hexahedron with one face represented in the first 4 points in counter-clockwise order and the next 4 points representing the opposite face in the same order). For Wall types, elements will be 1 or 2 points long. For Control Volume types, the first element in the list will be 1 point long (indicating the node for which the control volume was created) and remaining elements will be 4 points long (a quadrangle, defined in counter-clockwise order by the right-hand rule) defining the control volume. For Deviation types, elements will be 2 points long: the first is the base point on the linear cell and the second is the projected point on the constrained database.
-type typeVar | This optional parameter is a string variable name that will be assigned with the type of element used to measure the examine function. It will be Point, Line, Area, Volume, Wall, Voxel, UnsVoxel, ControlVolume, or Deviation. |
entity | This parameter is the pw::Entity object to query. |
boundary | For the DatabaseProximityBoundary metric, this parameter is the boundary of a pw::Surface, pw::SurfaceTrim, pw::Quilt, or pw::Model to query. For the DatabaseEdgeTolerance metric, it is the boundary of a pw::SurfaceTrim object belonging to one of the entities being examined. |
index | This parameter is the point or cell index within the entity. It will either be a 1-, 2-, or 3-integer value depending on the entity type. |
This action returns a list of vector XYZs.
$examine getCategories
This action gets the list of categories for which separate counts are maintained.
None
This action returns a list of strings representing the available categories.
$examine getCategoryCount category
This action gets the specified category count for the examine function.
category | This parameter is a string representing the category name. The full list can be retrieved by calling the getCategories function. Most examine functions will not have any categories. The BlockJacobian and DomainJacobian functions support “Positive”, “PositiveSkew”, “Zero”, “Negative”, and “NegativeSkew”. The OnDatabase functions support “Off” and “On”. The OnDatabaseSources functions support “Off”, “On”, and any constraining database surface. The BlockCellType functions support “Tet”, “Pryamid”, “Prism”, and “Hex”. The DomainCellType function supports “Tri” and “Quad”. The DomainCellIntersection function supports “NotIntersected” and “Intersected”, and domain intersection categories. |
This action returns the integer count for that category.
$examine setCurrentHighlighterPosition point
This action gets the constant U and V lines for the examined entity at a given point.
point | A point representing either a database coordinate on one of the examined database entities, or an XYZ value that will be projected to the closest database entity |
nothing
$examine getCurrentHighlighterPosition
This action gets the value of the current highlighter position. An error is raised if no position is set or if the function does not support a highlighter.
none
point value indicating the highlighter position.
This action creates an examine object.
pw::Examine create type
This action gets a list of allowable function names.
pw::Examine getFunctionNames
This action adds a cut to the list of saved cuts for block examine.
pw::Examine addSavedCut type value <block | form> ?-excludeCellTypes type_list? ?user_normal?
This action removes a cut from the list of saved cuts for block examine.
pw::Examine removeSavedCut type value <block | form> ?-excludeCellTypes type_list? ?user_normal?
This action gets the number of saved cuts for block examine.
pw::Examine getSavedCutCount
This action gets the specified saved cut for block examine.
pw::Examine getSavedCut index
This action reports statistics about the cell area of domains.
pw::Examine domainArea ?-intervals number? resultsVar domain_list
This action reports statistics about the minimum skew of domains.
pw::Examine domainSkewMinimum ?-intervals number? resultsVar domain_list
This action reports statistics about the maximum skew of domains.
pw::Examine domainSkewMaximum ?-intervals number? resultsVar domain_list
This action reports statistics about the skew angle of domains.
pw::Examine domainSkewAngle ?-intervals number? resultsVar domain_list
This action reports statistics about the centroid X coordinate of domains.
pw::Examine domainCentroidX ?-intervals number? resultsVar domain_list
This action reports statistics about the centroid Y coordinate of domains.
pw::Examine domainCentroidY ?-intervals number? resultsVar domain_list
This action reports statistics about the centroid Z coordinate of domains.
pw::Examine domainCentroidZ ?-intervals number? resultsVar domain_list
This action reports statistics about the cell volume of blocks.
pw::Examine blockVolume ?-intervals number? resultsVar block_list
This action reports statistics about the cell minimum skew of blocks.
pw::Examine blockSkewMinimum ?-intervals number? resultsVar block_list
This action reports statistics about the cell maximum skew of blocks.
pw::Examine blockSkewMaximum ?-intervals number? resultsVar block_list
This action reports statistics about the cell skew angle of blocks.
pw::Examine blockSkewAngle ?-intervals number? resultsVar block_list
This action reports statistics about the cell centroid X coordinate of blocks.
pw::Examine blockCentroidX ?-intervals number? resultsVar block_list
This action reports statistics about the cell centroid Y coordinate of blocks.
pw::Examine blockCentroidY ?-intervals number? resultsVar block_list
This action reports statistics about the cell centroid Z coordinate of blocks.
pw::Examine blockCentroidZ ?-intervals number? resultsVar block_list
This action reports statistics about the blocks’ Jacobians.
pw::Examine blockJacobian ?-intervals number? resultsVar block_list
This action deletes this examine object.
$examine delete
This action clears any computed data.
$examine clear
This action executes the examine function for each entity added to the examine object.
$examine examine ?-excludeCellTypes type_list?
This action processes the computed examine data again with any modified values in the interval count or range limits without recalculating the examine functions on each entity.
$examine refilter
This action gets the average value computed during the last call to examine.
$examine getAverage
This action gets the maximum value computed during the last call to examine.
$examine getMaximum ?-entity entVar? ?-location locVar?
This action gets the minimum value computed during the last call to examine.
$examine getMinimum ?-entity entVar? ?-location locVar?
This action gets the number of entities being examined and optionally sets a variable to the list of entities.
$examine getEntityCount ?-entities entsVar?
This action the list of entities being examined.
$examine getEntities
This action adds one or more entities to the examine object.
$examine addEntity entities
This action removes one or more entities from the examine object.
$examine removeEntity entities
This action removes all entities from the examine object.
$examine removeAll
This action returns the lower and upper cutoff limits.
$examine getRangeLimits
This action sets the lower and upper cutoff limits to be applied during the next call to examine or refilter.
$examine setRangeLimits < None | lower > < None | upper >
This action gets the number of cells or points that were below the lower cutoff range during the last examine or refilter call.
$examine getBelowRange
This action gets the number of cells or points between the lower and upper cutoff limits (inclusive) during the last examine or refilter call.
$examine getInRange
This action gets the number of cells or points that were above the upper cutoff range during the last examine call.
$examine getAboveRange
This action gets the number of intervals used for the histogram when examine or refilter was last run.
$examine getIntervalCount
This action sets the number of intervals to use for the histogram.
$examine setIntervalCount count
This action gets the limits of all intervals in the histogram.
$examine getIntervalLimits
This action gets the number of values in the specified interval.
$examine getIntervalTotal interval
This action gets the number of values in all intervals.
$examine getIntervalTotals
This action gets the computed value at a location within an entity.
$examine getValue < entity | boundary > index
This action gets the list of computed values within an entity.
$examine getValues < entity | boundary >
This action gets the computed value at a grid point location within an entity.
$examine getValueAtPoint entity index
This action gets the number of computed values either for a specific entity or for all entities.
$examine getValueCount ?< entity | boundary >?
This action gets the sample point at a location within an entity.
$examine getXYZ < entity | boundary > index
This action gets the grid or database coordinates for the examined element of an entity at a given point or cell index depending upon whether grid or database entities are being examined.
$examine getStencil ?-type typeVar? < entity | boundary > index
This action gets the XYZ values for the examined element of an entity at a given point or cell index.
$examine getStencilXYZs ?-type type_var? < entity | boundary > index
This action gets the list of categories for which separate counts are maintained.
$examine getCategories
This action gets the specified category count for the examine function.
$examine getCategoryCount category
This action gets the constant U and V lines for the examined entity at a given point.
$examine setCurrentHighlighterPosition point
This action gets the value of the current highlighter position.
$examine getCurrentHighlighterPosition