10.38. Read EDAX OIMAnalysis Data (.h5)

Group (Subgroup)

Import/Export (Import)

Description

This Filter will read a single .h5 file into a new Image Geometry, allowing the immediate use of Filters on the data instead of having to generate the intermediate .h5ebsd file. A Cell Attribute Matrix and Ensemble Attribute Matrix** will also be created to hold the imported EBSD information. Currently, the user has no control over the names of the created Attribute Arrays.

User interface before entering a proper "Z Spacing" value and selecting which scans to include.

User interface AFTER setting the "Z Spacing" and selecting files.

Notes About Reference Frames

The user should be aware that simply reading the file then performing operations that are dependent on the proper crystallographic and sample reference frame will be undefined or simply wrong. In order to bring the crystal reference frame and sample reference frame into coincidence, rotations will need to be applied to the data. The recommended filters are:

If the data has come from a TSL acquisition system and the settings of the acquisition software were in the default modes, the following reference frame transformations may need to be performed based on the version of the OIM Analysis software being used to collect the data:

Crystal Reference Frame: 90^o about the <001> Axis
Sample Reference Frame: 180^o about the <010> Axis

Important Consideration for Sample Reference Frame

If the user is importing more than a single slice from the HDF5 file and using the “Rotate Sample Reference Frame” filter, the user should CHECK the option ON for “Perform Slice By Slice Transform”.

Thresholding out Unindexed Scan Points

The user also may want to assign un-indexed pixels to be ignored by flagging them as “bad”. The Threshold Objects Filter can be used to define this mask by thresholding on values such as Confidence Index > xx or Image Quality > desired quality.

Input Parameter(s)

Parameter Name	Parameter Type	Parameter Notes	Description
Scan Names	orientationanalysis.OEMEbsdScanSelection		The name of the scan in the .h5 file. EDAX can store multiple scans in a single file
Origin	Vector of Float32 Values	Order=x,y,z	The origin of the volume
Z Spacing (Microns)	Scalar Value	Float32	The spacing in microns between each layer.
Import Pattern Data	Bool		Whether or not to import the pattern data

Output Image Geometry

Parameter Name	Parameter Type	Parameter Notes	Description
Image Geometry	DataGroupCreation		The path to the created Image Geometry

Output Cell Attribute Matrix

Parameter Name	Parameter Type	Parameter Notes	Description
Cell Attribute Matrix	DataObjectName		The name of the cell data attribute matrix for the created Image Geometry

Output Ensemble Attribute Matrix

Parameter Name	Parameter Type	Parameter Notes	Description
Ensemble Attribute Matrix	DataObjectName		The Attribute Matrix where the phase information is stored.

Example Pipelines

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.