the map a file holds, read by the loader its extension names; MATLAB’s loadEBSD and its interfaces loadEBSD_ang, loadEBSD_ctf, …

Syntax

ebsd = loadEBSD('map.ang')

An EDAX file, its phases from the header.

ebsd = loadEBSD('map.ang', setting=1)

Another alignment of the Euler angles and the map.

ebsd = loadEBSD('map.ang', crystalFrame('m-3m', mineral='Iron bcc'))

The phases of the file replaced.

ebsd = loadEBSD('map.txt', cs, columnNames=['phi1', 'Phi', 'phi2', 'x', 'y'], radians=True)

A table.

ebsd = loadEBSD('map.dat', interface='ang')

The format named rather than read off the name.

ebsd = loadEBSD('map.ang', grid=False)

The measurements as a list.

maps = loadEBSD(['a.ang', 'b.ctf'])

One map per file.

Description

The extension chooses the loader: .ang (EDAX, EMSphInx, the ACOM export of NanoMEGAS), .ctf (Oxford), .cpr/.crc, .osc and the vendors’ HDF5 files (.h5, .h5oina, .oh5, .dream3d, …); any other file is read as a table of named columns. A vendor file declares its phases; a table states none, so CS is required for one.

Every other keyword goes to the format’s loader. An .ang file takes setting, the alignment of the Euler angles and the map, 1 to 4 (2 by default, 4 for an ACOM file), 0 for no correction, or eulerCorrection, the rotation itself; scanUnit, the unit of the positions (‘nm’ for an ACOM file); and EDAX=True or EMSphInx=True, how the phase column is numbered, which the header otherwise tells (EMSphInx names no material). A table takes columnNames, columns, radians, delimiter, header and the Euler convention as a positional string.

A complete scan comes back gridified, its arrays in map shape, unless grid=False or the preference gridifyOnImport is off; a scan whose positions do not form a grid stays a list and says why. MATLAB’s headerOnly is inspectEBSD here.

Input

fname str or path, the file; or a list of them, read one by one
CS crystalFrame or a list of them, the phases, the not indexed one first or left out; required for a table, for a vendor file one frame per phase it declares

Keywords

keyword default description
interface None the format, ‘ang’, ‘ctf’, ‘crc’, ‘osc’, ‘h5’, …, instead of the extension
grid True put a complete scan on its grid while it is read

Output

ebsd EBSD, or a list of EBSD for a list of files

See also

EBSD.load, inspectEBSD, importWizard, export, EBSDImport, EBSDReferenceFrame, EBSDInterfaceHDF5

MATLAB’s loadEBSD_h5

source

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_h5_py.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.