Skip to content

Import HDF5 Dataset

Group (Subgroup)

Core (IO/Read)

Description

This Filter allows the user to import datasets from an HDF5 file and store them as attribute arrays in DREAM.3D. This filter supports importing datasets with any number of dimensions, as long as the created attribute array's total number of components and the tuple count of the destination attribute matrix multiply together to match the HDF5 dataset's total number of elements.

The component dimensions are input as a comma-delimited list of dimensional values. For example: 1. 3, 4 = 3x4 2. 5, 2, 1 = 5x2x1 3. 6 = 6

Examples ###

  1. Suppose we have a 1D dataset in an HDF5 file with dimension 12,000. We can input component dimensions of 5, 2, 2 and set the destination attribute matrix tuple dimensions to 35 x 5 x 2 x 2

    The total number of elements for the HDF5 dataset is 12,000. The total number of tuples in the destination attribute matrix is 35*5*2*2 = 700. The total number of components for the created attribute array is 5*2*2 = 20. The total number of elements for the created attribute array will be 700*20 = 14,000.

    14,000 does not equal 12,000, so this will result in a preflight error.

  2. Suppose we have a 3D dataset in an HDF5 file with dimensions 1 x 16 x 1001 x 1001.

    We can input component dimensions of 2 and set our destination attribute matrix tuple dimensions to 134 x 67.

    The total number of elements for the HDF5 dataset is 1*16*1001*1001 = 16,032,016. The total number of tuples in the destination attribute matrix is 8*1001*1001 = 8,016,008. The total number of components for the created attribute array is 2. The total number of elements for the created attribute array will be 8,016,008*2 = 16,032,016.

    The total number of elements of the created attribute array (16,032,016) equals the total number of elements of the HDF5 dataset (16,032,016), so we can import this dataset without errors (see below).

Parameters

Name Type Description
HDF5 File QString The path to the HDF5 file
Checked Datasets N/A The checked datasets in the file tree to import
Component Dimensions QString The component dimensions that the imported dataset will have. This is a comma-delimited list of dimensional values

Required Geometry

Not Applicable

Required Objects

Kind Default Name Type Component Dimensions Description
Attribute Matrix None DataArrayPath N/A Attribute Matrix used to store imported data

Created Objects

Kind Default Name Type Component Dimensions Description
Attribute Array(s) Name of dataset(s) from HDF5 file Type from HDF5 file Input as a filter parameter The created Attribute Array(s)

Example Pipelines

Please see the description file distributed with this Plugin

DREAM.3D Mailing Lists