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)