DREAM3D User Manual
Read Field Info File

Group (Subgroup)

IO Filters (Input)

Description

This filter reads information about the Fields that are in the sample. The basic format of the file is the number of Fields on the first line of the file followed by columnar formatted data listing: Field Id, PhaseID, Euler Angle 1, Euler Angle 2 and Euler Angle 3. *If you do not have Euler Angle data for each Field then substituting Zero (0.0) is fine.

__**Field** Ids start from One (1) and Phase Ids start from One (1). DREAM3D uses Field Id Zero(0) internally which has several ramifications which the user needs to understand. Statistics will NOT be calculated for any Cell or field data with a value of Zero (0). If your segmented data numbering starts with Zero (0) then the user needs to find a way to renumber Field=0 to another value. Max + 1 typically.__ For example if you have a file with 123 Fields and 2 phases then the file would be similar to the following:

123
1   2  1.2  0.4  0.8
2   1  0.8  0.99  1.0
.....
121 1 0.3  0.5  0.9
123 2 1.0  1.1  0.03

Note the arrays that are being created.
If the option to Create Cell Level Arrays is selected then any existing arrays will be OVER WRITTEN with new data derived from the field data being written. In plain if the user uses this filter to read in Phase and Euler Angle data for their data set and the Create Cell Level Arrays is ON/True then any existing EulerAngles and Phase Arrays at the Cell level will be over written with data derived from these new Field level arrays. If you have the Create Cell Level Arrays set to OFF/False then those cell level arrays will not be created.

Parameters

Name Type
Input Field Info File Input File
Create Cell Level Arrays Boolean (On or Off)

Required DataContainers

Voxel

Required Arrays

Type Default Name Description Comment Filters Known to Create Data
Cell GrainIds Ids (ints) that specify to which Field each Cell belongs. Values should be present from segmentation of experimental data or synthetic generation and cannot be determined by this filter. Not having these values will result in the filter to fail/not execute. Segment Fields (Misorientation, C-Axis Misorientation, Scalar) (Reconstruction), Read Dx File (IO), Read Ph File (IO), Pack Primary Phases (SyntheticBuilding), Insert Precipitate Phases (SyntheticBuilding), Establish Matrix Phase (SyntheticBuilding)

Created Arrays

Type Default Name Description Comment
Cell CellEulerAngles Three (3) angles (floats) defining the orientation of the Cell in Bunge convention (Z-X-Z) Only created if boolean is checked
Cell CellPhases Phase Id (int) specifying the phase of the Cell Only created if boolean is checked
Field FieldEulerAngles Three (3) angles (floats) defining the orientation of each Field in Bunge convention (Z-X-Z)
Field FieldPhases Phase Id (int) specifying the phase of the Field

Authors

Copyright: 2012 Michael A. Groeber (AFRL),2012 Michael A. Jackson (BlueQuartz Software)

Contact Info: dream.nosp@m.3d@b.nosp@m.luequ.nosp@m.artz.nosp@m..net

Version: 1.0.0

License: See the License.txt file that came with DREAM3D.

See a bug? Does this documentation need updated with a citation? Send comments, corrections and additions to The DREAM3D development team