load

(method of EBSD)

load ebsd data from file

Description

EBSD.load is a high level method for importing EBSD data from files. If possible it autodetects the format of the file. Supported formats are listed here. Additionally, EBSD data can be read from column aligned text file or excel spread sheets. In those cases it is neccesary to tell MTEX the column positions of the spatial coordinates, the phase information as well as Euler angles.

Syntax

ebsd = EBSD.load('filename.ang')
ebsd = EBSD.load('filename.ctf')
ebsd = EBSD.load('filename.osc')
ebsd = EBSD.load('filename.hf5')

csList = {'notIndexed',...
CS = {'notIndexed',...
       crystalSymmetry('m-3m','mineral','Fe'),...
       crystalSymmetry('m-3m','mineral','Mg')};
ebsd = EBSD.load(fname,'cs',cs,'ColumnNames',{'x','y','Euler1','Euler2','Euler3','phase'})

Input

fname

filename

cs

crystalSymmetry or cell array of crystalSymmetry

param,val

Parameters and values that control load

Parameter	Description
`'ColumnNames'`	names of the colums to be imported, mandatory are euler 1, euler 2, euler 3
`'Columns'`	postions of the columns to be imported
`'radians'`	treat input in radiand
`'delimiter'`	delimiter between numbers
`'header'`	number of header lines
`'Bunge'`	[phi1 Phi phi2] Euler angle in Bunge convention (default)
`'passive'`

Output

ebsd

EBSD

Example

fname = fullfile(mtexDataPath,'EBSD','85_829grad_07_09_06.txt');
CS = {'notIndexed',...
crystalSymmetry('m-3m','mineral','Fe'),...
crystalSymmetry('m-3m','mineral','Mg')};
SS = specimenSymmetry('triclinic');
ebsd = EBSD.load(fname,'CS',CS,'SS',SS, 'ColumnNames', ...
{'Index' 'Phase' 'x' 'y' 'Euler1' 'Euler2' 'Euler3' 'MAD' 'BC' 'BS'...
'Bands' 'Error' 'ReliabilityIndex'}, 'Bunge')