Importing EBSD Data edit page

MTEX allows you to import EBSD data from a wide variety of file format. 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 straight forward 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 comercials 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 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:

The import wizard allows you to either creates directly a workspace variable of type EBSD or to generates an m-file which contains all the customizations and allows you to import the data in future sessions without the import wizzard. 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:

## Supported Data Formats

MTEX supports the following EBSD data formats:

 EDAX ascii files. Bruker ascii files. Oxford binary files. Oxford single orientation files. HKL single orientation files. Dream 3d single orientation files. single orientation files. Bruker, EDAX, Dream 3d binary files. EDAX binary files. Oxford ascii files. ASCII files with Euler angles as columns.

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.

In case that the EBSD format is not supported, you can write an interface by your own to import the data. Once you have written such an interface that reads data from certain data files and generates an EBSD object you can integrate this method into MTEX by copying it into the folder MTEX/qta/interfaces and rename your function loadEBSD_xxx. Then it will be automatical recognized by the import wizard. Examples how to write such an interface can be found in the directory MTEX/qta/interfaces.