Sample Triangle Geometry at Specified Points¶
Group (Subgroup)¶
Sampling (Resolution)
Description¶
This Filter "samples" a triangulated surface mesh with a specified list of Vertices (or points) read from a file. The sampling is performed by the following steps:
- Determine the bounding box and Triangle list of each Feature by scanning all Triangles and noting the Features on either side of the Triangle
- For each Vertex read from the file, determine which bounding box(es) they fall in (Note: the bounding box of multiple Features can overlap)
- For each bounding box a Vertex falls in, check against that Feature's Triangle list to determine if the Vertex falls within that n-sided polyhedra (Note: if the surface mesh is conformal, then each Vertex will only belong to one Feature, but if not, the last Feature the Vertex is found to fall inside of will own the Vertex)
- Assign the Feature number that the Vertex falls within to the Feature Ids array in the new Vertex geometry
The Filter will write out a file with the list of Feature Ids for the Vertices. The Filter also creates a new Data Container (named SpecifiedPoints) to hold the Vertex geometry, a Vertex Attribute Matrix (named SpecifiedPointsData) in that Data Container and the Feature Ids that live on each Vertex. The user does not currently have control over the names of these created entities.
Example Input¶
Number of Points
X, Y, Z
X, Y, Z
X, Y, Z
.
.
.
X, Y, Z
Parameters¶
| Name | Type | Description |
|---|---|---|
| Specified Points File | File Path | The input specified points file path |
| Sampled Values File | File Path | The output sampled values file path |
Required Geometry¶
Triangle
Required Objects¶
| Kind | Default Name | Type | Component Dimensions | Description |
|---|---|---|---|---|
| Face Attribute Array | FaceLabels | int32_t | (2) | Specifies which Features are on either side of each Face |
Created Objects¶
| Kind | Default Name | Type | Component Dimensions | Description |
|---|---|---|---|---|
| Data Container | SpecifiedPoints | N/A | N/A | Created Data Container to hold sampled points Geometry |
| Attribute Matrix | SpecifiedPointsData | Vertex | N/A | Created Vertex Attribute Matrix to hold sampled points data |
| Vertex Attribute Array | FeatureIds | int32_t | (1) | Specifies to which Feature each Vertex belongs |
Example Pipelines¶
License & Copyright¶
Please see the description file distributed with this Plugin
DREAM.3D Mailing Lists¶
If you need more help with a Filter, please consider asking your question on the DREAM.3D Users Google group!