VTK STRUCTURED_POINTS Importer¶
Group (Subgroup)¶
IO (Input)
Description¶
This Filter reads a STRUCTURED_POINTS type of 3D array from a legacy .vtk file. A STRUCTURED_POINTS file is a more general type of Image Geometry where data can be stored at the vertices of each voxel. The currently supported VTK dataset attribute types are SCALARS and VECTORS. Other dataset attributes will not be read correctly and may cause issues when running the Filter. The VTK data must be POINT_DATA and/or CELL_DATA and can be either binary or ASCII. The Filter will create a new Data Container with an Image geometry for each of the types of data (i.e., POINT_DATA and/or CELL_DATA) selected to be read, along with a Cell Attribute Matrix to hold the imported data.
Note: In a STRUCTURED_POINTS file, POINT_DATA lies on the vertices of each unit element voxel (i.e., eight values per voxel), while CELL_DATA lies at the voxel center. This Filter will import both types of data as Image Geometries, since either form a structured rectilinear grid. This is to enable easier visualization of the POINT_DATA, and to enable greater flexibility when using DREAM.3D analysis tools, many of which rely on an Image Geometry.
Example Input¶
# vtk DataFile Version 2.0
GrainIds Stored in Vtk File
ASCII
DATASET STRUCTURED_POINTS
DIMENSIONS 3 4 6
SPACING 1 1 1
ORIGIN 0 0 0
POINT_DATA 72
SCALARS GrainIds char 1
LOOKUP_TABLE default
0 0 0 0 0 0 0 0 0 0 0 0
0 5 10 15 20 25 25 20 15
10 5 0 0 10 20 30 40 50
50 40 30 20 10 0 0 10 20
30 40 50 50 40 30 20 10 0
0 5 10 15 20 25 25 20 15
10 5 0 0 0 0 0 0 0 0 0 0 0 0 0
Parameters¶
| Name | Type | Description |
|---|---|---|
| Input VTK File | File Path | Input .vtk file path |
| Read Point Data | bool | Whether the read point data from the .vtk file |
| Read Cell Data | bool | Whether the read cell data from the .vtk file |
Required Geometry¶
Not Applicable
Required Objects¶
None
Created Objects¶
| Kind | Default Name | Type | Component Dimensions | Description |
|---|---|---|---|---|
| Data Container | ImageDataContainer_PointData | N/A | N/A | Created Data Container name with an Image Geometry storing POINT_DATA. Only created if Read Point Data is checked |
| Data Container | ImageDataContainer_CellData | N/A | N/A | Created Data Container name with an Image Geometry storing CELL_DATA. Only created if Read Cell Data is checked |
| Attribute Matrix | CellData | Cell | N/A | Created Cell Attribute Matrix storing POINT_DATA. Only created if Read Point Data is checked |
| Attribute Matrix | CellData | Cell | N/A | Created Cell Attribute Matrix storing CELL_DATA. Only created if Read Cell Data is checked |
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!