MTEX allows you to import EBSD data from a wide variety of file formats. In the most simplest case import can be done by the command EBSD.load
This command automatically detects the file format and generates a variable of type EBSD which contains all the information of the EBSD data set. Let us quickly do an orientation plot of the Magnesium phase
The variable of type EBSD is the starting point for all further analysis, e.g., grain reconstruction, ODF reconstruction, misorientation analysis, etc.
Importing EBSD data using the import wizard
In many cases however, importing EBSD data is not that straightforward as suggested above. The reason is that during the measuring process different reference systems are involved and resulting coordinates, i.e., the spatial coordinates and the Euler angles, are often not stored in a consistent way by commercial software. Please read EBSD Reference Systems for more information about how to set up reference frames correctly.
In order to help the user to import EBSD data consistently to a fixed specimen reference frame (which the user should know), MTEX provide the import wizard as a graphical user interface. The import_wizard
can be started either by typing into the command line
EBSD Data files can be also imported via the file browser by choosing Import Data from the context menu of the selected file if its file extension was registered with mtex_settings.m
The import wizard guides through the correct setup of:
- crystal symmetries associated with phases
- specimen symmetry and plotting conventions
The import wizard allows you to either create directly a workspace variable of type EBSD or to generates a m-file, which contains all the customization and allows you to import the data in future sessions without the import wizard. This last option is highly recommended as the created script is also a good starting point for further analysis and data processing.
The Import Script
A script generated by the import wizard has approximately the following form:
Running this script imports the data into a variable named ebsd
. From this point, the script can be extended to your needs, e.g:
Supported Data Formats
MTEX supports the following EBSD data formats:
EDAX ascii files. |
single orientation files. |
||
Bruker ascii files. |
Bruker, EDAX, Dream 3d binary files. |
||
Oxford binary files. |
EDAX binary files. |
||
Oxford single orientation files. |
Oxford ascii files. |
||
HKL single orientation files. |
ASCII files with Euler angles as columns. |
||
Dream 3d single orientation files. |
If the data is recognized as an ASCII list of orientations, phase and spatial coordinates in the form
alpha_1 beta_1 gamma_1 phase_1 x_1 y_1 alpha_2 beta_2 gamma_2 phase_2 x_2 y_2 alpha_3 beta_3 gamma_3 phase_3 x_3 y_3 . . . . . . . . . . . . . . . . . . alpha_M beta_M gamma_M phase_m x_m y_m
an additional tool supports you to associated the columns with the corresponding properties.
Writing your own interface
In the rare case of an EBSD format that is not supported, the user can write its own interface to import the data. Once you have successfully written that, you can integrate this method into MTEX by copying it into the folder mtex/interfaces
and rename your function loadEBSD_xxx
. Then it will be automatically recognized by the import wizard. Examples how to write such an interface can be found in the directory mtex/interfaces
.