8.83. Interpolate Point Cloud to Regular Grid
Group (Subgroup)
Sampling (Interpolation)
Description
This Filter interpolates the values of arrays stored in a Vertex Geometry onto a user-selected Image Geometry. The user defines the (x,y,z) radii of a kernel in real space units. This kernel can be intialized to either uniform or Gaussian. The interpolation algorithm proceeds as follows:
The kernel radii defined by the user in real space units are converted into voxel units, based on the spacing of the supplied Image Geometry.
The kernel is centered on each vertex in the Vertex Geometry.
The values of each Attribute Array on the centered vertex are associated to each voxel intersected by the kernel. This stored value is multiplied by the value of the kernel.
The result of the above approach is a list of data at each voxel in the Image Geometry for each interpolated Attribute Array. These lists may be of different lengths within each voxel, since the kernels from each point may overlap. This duplication may result in significant memory usage if the number of points is large; the user may select a subset of arrays to interpolate to alleviate this issue. Note that all arrays selected for interpolation must be scalar.
A mask may be supplied to the filter. Points that are not within the mask are ignored during interpolation. Additionally, the distances between each voxel and the source point for the intersecting kernel may be stored; this significantly increases the required memory. Arrays may be passed through to the image geometry without applying any interpolation. This operation is equivalent to used a uniform kernel.
Input Parameter(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Use Mask Array |
Bool |
Specifies whether or not to use a mask array |
|
Store Kernel Distances |
Bool |
Specifies whether or not to store kernel distances |
|
Interpolation Technique |
Choices |
Selected Interpolation Technique |
|
Kernel Size |
Vector of Float32 Values |
Order=x,y,z |
Specifies the kernel size |
Gaussian Sigmas |
Vector of Float32 Values |
Order=x,y,z |
Specifies the Gaussian sigmas |
Input Data Objects
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Vertex Geometry to Interpolate |
Geometry Selection |
Vertex |
DataPath to geometry to interpolate |
Interpolated Image Geometry |
Geometry Selection |
Image |
DataPath to interpolated geometry |
Voxel Indices |
Array Selection |
Allowed Types: uint64 Comp. Shape: 1 |
DataPath to voxel indices |
Mask |
Array Selection |
Allowed Types: boolean Comp. Shape: 1 |
DataPath to the boolean mask array. Values that are true will mark that cell/point as usable. |
Attribute Arrays to Interpolate |
MultiArraySelection |
DataPaths to interpolate |
|
Attribute Arrays to Copy |
MultiArraySelection |
DataPaths to copy |
Output Data Object(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Interpolated Group |
DataObjectName |
DataPath to created DataGroup for interpolated data |
|
Kernel Distances Group |
DataObjectName |
DataPath to created DataGroup for kernel distances data |
License & Copyright
Please see the description file distributed with this plugin.
DREAM3D-NX Help
If you need help, need to file a bug report or want to request a new feature, please head over to the DREAM3DNX-Issues GitHub site where the community of DREAM3D-NX users can help answer your questions.