Import Pole Figure Data edit page

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:

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.

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.

## 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.:

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.