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 (y↓→x)
Phase Orientations Mineral Color Symmetry Crystal reference frame
0 11411 (19%) notIndexed none
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
Citing this page.
This page is part of the documentation of
MTEX, a free and open
source MATLAB toolbox for analyzing and modeling crystallographic textures.
It was written by The MTEX Developers and is published at
https://mtex-toolbox.github.io/loadEBSD_generic.html.
If you use MTEX, or reuse text or figures from this page, in your research,
please cite
F. Bachmann, R. Hielscher, H. Schaeben: Texture Analysis with MTEX - Free and Open Source Software Toolbox, Solid State Phenomena 160 (2010), 63-68. 10.4028/www.scientific.net/SSP.160.63
BibTeX
@article{bachmann2010mtex,
author = {F. Bachmann and R. Hielscher and H. Schaeben},
title = {Texture Analysis with MTEX - Free and Open Source Software Toolbox},
journal = {Solid State Phenomena},
volume = {160},
pages = {63-68},
year = {2010},
doi = {10.4028/www.scientific.net/SSP.160.63},
url = {https://doi.org/10.4028/www.scientific.net/SSP.160.63}
}Other papers describing specific MTEX methods are listed under Publications — please cite the one that best fits your application. The MTEX source code is licensed under the GNU General Public License v2.0; the text and figures of this documentation are licensed under CC BY 4.0, which permits reuse — including by automated systems — provided The MTEX Developers and this page are credited.