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')};

ebsd = EBSD.load(fname,'CS',CS, 'ColumnNames', ...
{'Index' 'Phase' 'x' 'y' 'Euler1' 'Euler2' 'Euler3' 'MAD' 'BC' 'BS'...
'Bands' 'Error' 'ReliabilityIndex'}, 'Bunge')

ebsd = EBSDsquare (y↓→x, row↓→col)
 
 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, oldId
 Scan unit : um
 X x Y x Z : [0 → 254] x [90 → 175] x [0 → 0]
 Normal vector: (0,0,1)
 Square grid  :143 x 425

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/EBSD3.load.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.

EBSD3.load