the pole figures a file holds, or the files of a list, read by their format; MATLAB’s PoleFigure.load and loadPoleFigure

Syntax

pf = loadPoleFigure('Q(10-10)_amp.cnv', cs)

The format and the direction found from the file.

pf = PoleFigure.load([f1, f2, f3], cs)

Several files, one pole figure or more each.

pf = loadPoleFigure([f1, f2], [h1, [h2, h3]], cs, superposition=[1, [0.52, 1.23]])

Given directions, a superposed pair weighted.

pf = loadPoleFigure('scan.dat', cs, interface='geesthacht')

A format named.

pf = loadPoleFigure('scan.txt', h, cs, columnNames=['polar angle', 'azimuth angle', 'intensity'], radians=True)

A table.

Description

The format follows the extension and the marker the file carries; interface= names it when the extension leaves it open, one of ‘dubna’, ‘ana’, ‘popla’, ‘labotex’, ‘aachen’, ‘aachen_exp’, ‘philips’, ‘plf’, ‘ibm’, ‘out1’, ‘slc’, ‘beartex’, ‘xrd’, ‘siemens’, ‘uxd’, ‘juelich’, ‘geesthacht’, ‘nja’, ‘pwd’, ‘rigaku’, ‘rigaku_dat’, ‘rigaku_txt’, ‘gpol’, ‘rw1’, ‘xrdml’ or ‘generic’.

The crystal directions are read off the file names (string2Miller) unless given. Give one per file or, for a file of several pole figures, a list of them; a list inside it is a superposition of directions, weighted equally unless superposition gives the weights. The frames are given positionally.

A table option (columnNames, columns, header, delimiter, radians) reads a table whose columns the caller names: the polar angle and the azimuth, in degrees unless radians=True, or x, y, z, and the intensity.

Input

fname a file name or a list of them
h Miller, the crystal directions, a list of them, a list for a superposition (optional)
cs, ss the crystal and the specimen frame (optional)

Keywords

keyword default description
interface None the format: ‘dubna’, ‘uxd’, ‘geesthacht’, ‘xrdml’, ‘generic’, …; by default told by the extension and the marker the file carries
superposition None the structure coefficients of the directions, one number or a list of numbers per pole figure

Output

pf a PoleFigure

See also

PoleFigure, string2Miller, exportPoleFigure, mtexdata

MATLAB’s loadPoleFigure_aachen

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