8.103. Read Vtk Structured Points File

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 DREAM3D-NX 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

Input Parameter(s)

Parameter Name

Parameter Type

Parameter Notes

Description

Input VTK File

FileSystemPath

The path to the input file

Read Point Data

Bool

Determines whether or not the Point Data will be read.

Read Cell Data

Bool

Determines whether or not the Cell Data will be read.

Output Point Data

Parameter Name

Parameter Type

Parameter Notes

Description

Data Container [Point Data]

DataGroupCreation

The data container for the Point Data.

Attribute Matrix Name [Point Data]

DataObjectName

The attribute matrix for the Point Data.

Output Cell Data

Parameter Name

Parameter Type

Parameter Notes

Description

Data Container [Cell Data]

DataGroupCreation

The data container for the Cell Data.

Attribute Matrix Name [Cell Data]

DataObjectName

The attribute matrix for the Cell Data.