Importing pole figure data in MTEX means to create a PoleFigure object from data files containing diffraction data. Once such an object has been created the data can be analyzed and processed in many ways. Furthermore, such a PoleFigure object is the starting point for PoleFigure to ODF estimation.
Importing pole figure data using the import wizard
The import wizard can be started either by typing into the command line
or by using the start menu item Start/Toolboxes/MTEX/Import Wizard. Pole figure data 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 previously registered with the mtex_settings.m
The import wizard guides through the correct setup of:
- crystal symmetries associated with phases
- specimen symmetry and plotting conventions
- Miller indices of pole figures.
In the end, the imported wizard creates a workspace variable or generates a m-file loading the data automatically. Furthermore appending a template script allows radip data processing.
Supported Data Formats
The import wizard currently supports following pole figure formats:
EMSE ASCII pole figure format |
|
Dubna ASCII pole figure format, regular grid |
|
Dubna ASCII pole figure format, experimental grid |
|
Geesthacht ASCII pole figure format. |
|
Popla ASCII pole figure format. |
|
LaboTEX ASCII pole figure format |
|
Aachen ASCII pole figure format. |
|
IBM ASCII pole figure format. |
|
Juelich ASCII pole figure format. |
|
Seifert ASCII pole figure format. |
|
Graz ASCII pole figure format. |
|
Queens Univ. ASCII pole figure format. |
|
Siemens ASCII pole figure format. |
|
Philips ASCII pole figure format. |
|
BearTex ASCII pole figure format. |
|
SLC ASCII pole figure format. |
|
Bruker UXD ASCII pole figure format. |
|
Bruker XRD ASCII pole figure format. |
|
PANalytical XML data format. |
|
Aachen ASCII pole figure format. |
See PoleFigure.load for further information or follow the hyperlinks of the table above for an example.
If the interface is not automatically recognized, but the data has the form of an ASCII list:
polar_1 azimuthal_1 intensity_1 polar_2 azimuthal_2 intensity_2 polar_3 azimuthal_3 intensity_3 . . . . . . . . . polar_n azimuthal_n intensity_n
an additional tool asks you to associate the columns with the corresponding property. See also loadPoleFigure_generic, which provides an easy way to import diffraction data from such an ASCII list. The list may contain an arbitrary number of header lines, columns or comments and the actual order of the columns may be specified by options.
If you have any comments, remarks or request on interfaces please contact us.
The Import Script
Diffraction data stored in one of the formats above can also be imported using the command PoleFigure.load. It automatically detects the data format and imports the data. In dependency of the data format, it might be necessary to specify the Miller indices and the structure coefficients. The general syntax is
An import script generated by the import wizard
has the following form:
Once such a import script for pole figure data has been created, it can be easily modified and extend, e.g.:
Writing your own interface
MTEX also provides a way to import data from formats currently not supported directly. Therefore you can to use all standard MATLAB input and output commands to read the pole figure information, e.g. intensities, specimen directions, crystal directions directly from the data files. Then you have to call the constructor PoleFigure with these data to generate a PoleFigure object.
Once you have written an interface that reads data from certain data files and generates a PoleFigure object you can integrate this method into MTEX by copying it into the folder MTEX/qta/interfaces
. Then it will be automatically called by the methods PoleFigure.load and import_wizard. Examples how to write such an interface can be found in the directory MTEX/qta/interfaces
.