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

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!