loadEBSD_generic edit page

load ebsd data from generic text files

Description

loadEBSD_generic loads EBSD data from text or exel files that have a column oriented format as

x1 y1 phi1_1 Phi_1 phi2_1 phase_1
x2 y2 phi1_2 Phi_2 phi2_2 phase_2
x2 y3 phi1_3 Phi_3 phi2_3 phase_3
.      .       .       .
.      .       .       .
.      .       .       .
xM yM phi1_M Phi_M phi2_M phase_m

The assoziation of the columns as Euler angles, phase informationl, etc. is specified by the options ColumnNames and Columns. The files can be contain any number of header lines.

Syntax

ebsd   = loadEBSD_generic(fname,'ColumnNames',{'x','y','Euler1','Euler2','Euler3','phase'},'cs',cs)

Input

fname file name (text files only)
cs crystalSymmetry or cell array of crystalSymmetry

Options

ColumnNames names of the columns to be imported, mandatory are euler 1, euler 2, euler 3
Columns positions of the columns to be imported
radians treat input in radiant
delimiter delimiter between numbers
header number of header lines
Bunge [phi1 Phi phi2] Euler angle in Bunge convention (default)
ABG [alpha beta gamma] Euler angle in Mathies convention
passive

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 = loadEBSD_generic(fname,'CS',CS,'SS',SS, 'ColumnNames', ...
{'Index' 'Phase' 'x' 'y' 'Euler1' 'Euler2' 'Euler3' 'MAD' 'BC' 'BS'...
'Bands' 'Error' 'ReliabilityIndex'}, 'Bunge')
ebsd = EBSD
 
 Phase  Orientations     Mineral         Color  Symmetry  Crystal reference frame
     0   11411 (19%)  notIndexed                                                 
     1   48184 (79%)          Fe  LightSkyBlue      m-3m                         
     2   1180 (1.9%)          Mg  DarkSeaGreen      m-3m                         
 
 Properties: bands, bc, bs, error, index, mad, reliabilityindex
 Scan unit : um
 X x Y x Z : [0 254] x [90 175] x [0 0]
 Normal vector: (0,0,1)

See also

ImportEBSDData loadEBSD ebsd_demo