PoleFigure.load edit page

import pole figure data

Description

PoleFigure.load is a high level method for importing pole figure data from external files. It auto-detects the format of the file. As parameters the method requires the crystal and specimen symmetry. Additionally it is sometimes required to pass a list of crystal directions and a list of structure coefficients. See interfaces for an example how to import superposed pole figures. In the case of generic ASCII files each of which consist of a table containing in each row a specimen direction and a diffraction intensity see loadPoleFigure_generic for additional options. Furthermore, you can specify a comment to be associated with the data.

Syntax

pf = PoleFigure.load(fname)
fnames = {fname1,...,fnameN}  % define filename(s)
h = {h1,..,hN}                % define crystal directions
c = {c1,..,cN}                % define structure coefficients
pf = PoleFigure.load(fnames,h,cs,ss,'superposition',c)

Input

fname filename(s)
h1,...,hN Miller crystal directions
c1,...,cN structure coefficients for superposed pole figures (optional)
cs, ss crystal, specimen symmetry

Output

pf vector of PoleFigure

Options

interface specific interface to be used

See also

PoleFigureImport PoleFigure.calcODF Examples

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/PoleFigure.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.