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 necessary 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 |
Output
| ebsd | EBSD |
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 radiand |
| delimiter | delimiter between numbers |
| header | number of header lines |
| Bunge | [phi1 Phi phi2] Euler angle in Bunge convention (default) |
| 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 = EBSD.load(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)