Skip to content

Sample Triangle Geometry at Specified Points

Group (Subgroup)

Sampling (Resolution)


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:

  1. Determine the bounding box and Triangle list of each Feature by scanning all Triangles and noting the Features on either side of the Triangle
  2. For each Vertex read from the file, determine which bounding box(es) they fall in (Note: the bounding box of multiple Features can overlap)
  3. 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)
  4. 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


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


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

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!