10.52. Write StatsGenerator ODF Angle File
Group (Subgroup)
IO (Output)
Description
This Filter is used in a workflow where the user would like to generate a synthetic microstructure with an ODF that matches (as closely as possible) an existing experimental data set or other data set that is being mimicked. The basic workflow is the following:
Import Euler angle data (e.g., ANG or CTF files)
Optionally threshold the data so each cell is marked as allowable or not-allowable
Insert the “Export StatsGenerator ODF Angle File” Filter in the Pipeline
Run the Pipeline to produce the file
Launch StatsGenerator
Generate the data
Click on the ODF Tab
Click on the Bulk Load sub tab
Select the file that was just written
Load the data and inspect the ODF that was generated
Important Change from Earlier Versions of StatsGenerator
StatsGenerator can not load data from standard .ang or .ctf files. If you want to get the ODF from an existing experimental data set and you have one of those files then you must use the functionality of this filter
Notes on Implementation
A separate file is written for each phase
Spaces are the default as the delimiters between values. The user can select another value
Default values of 1.0 are used for both the weight and sigma. If the user needs a stronger texture due to a low number of angles then larger values should be used such as 10, 100 or even 1000.
The user has the option to convert the supplied Euler angles to degrees. StatsGenerator is able to import Euler angles as either degrees or radians based on user input, so the output type from this Filter could remain as radians or be converted to degrees. The user should remain cognizant of what representation their angles are in so that the correct option is chosen during the import process in StatsGenerator
Example File
The file written is a simple text file that contains a short comment section and a single Header line of data. All comment lines should come BEFORE the actual header line. There is a single header line in the form of “Key:Value” and then the lines of data.
# All lines starting with '#' are comments and should come before the header.
# DREAM3D-NX StatsGenerator Angles Input File
# DREAM3D-NX Version 6.1.107.0d8bad9
# Angle Data is space delimited.
# Euler0 Euler1 Euler2 Weight Sigma
Angle Count:100
0 0 0 1 1
3.6 1.8 3.6 1 1
7.2 3.6 7.2 1 1
10.8 5.4 10.8 1 1
14.4 7.2 14.4 1 1
The only required header line is:
Angle Count:100
There are 5 columns of data which are the 3 Euler Angles, the Weight Value and the Sigma Value.
Delimiter
Choice of delimiter is as follows:
0 = , (comma)
1 = ; (semicolon)
2 = (space) <==== DEFAULT VALUE
3 = : (colon)
4 = \t (tab)
Input Parameter(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Output File |
FileSystemPath |
The output angles file path |
|
Default Weight |
Scalar Value |
Float32 |
This value will be used for the Weight column |
Default Sigma |
Scalar Value |
Int32 |
This value will be used for the Sigma column |
Delimiter |
Choices |
The delimiter separating the data |
|
Convert to Degrees |
Bool |
Whether to convert the Euler angles from radians to degrees. If the Euler angles are already in degrees, this option will ‘convert’ the data again, resulting in garbage orientations! |
Optional Data Mask
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Only Write Good Elements |
Bool |
Whether to only write the Euler angles for those elements denoted as true in the supplied mask array |
|
Mask Array |
Array Selection |
Allowed Types: uint8, boolean Comp. Shape: 1 |
Used to define Elements as good or bad. Only required if Only Write Good Elements is checked |
Input Cell Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Euler Angles |
Array Selection |
Allowed Types: float32 Comp. Shape: 3 |
Three angles defining the orientation of the Element in Bunge convention (Z-X-Z) |
Phases |
Array Selection |
Allowed Types: int32 Comp. Shape: 1 |
Specifies to which Ensemble each Element belongs |
Example Pipelines
Export Small IN100 ODF Data (StatsGenerator)
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.