loadPoleFigure_generic edit page

load pole figure data from (theta,rho,intensity) files

Description

Without h the crystal direction is guessed from the file name, which only works if the file is named after its reflection. A name that carries any other number, e.g. a measurement id as in 110F-Creuz426sym.sum, may be read as a superposition of several crystal directions and give a pole figure that cannot be inverted. Pass the direction whenever the file name is not purely the reflection.

Syntax

[pf,varargin] = loadPoleFigure_generic(fname,varargin)

Input

fname file name (text files only)
h Miller crystal direction (optional)

Options

ColumnNames content of the columns to be imported
Columns positions of the columns to be imported
RADIANS treat input in radians
DELIMITER delimiter between numbers
HEADER number of header lines

Example

fname = [mtexDataPath '/PoleFigure/nja/seifert-111.nja'];
pf = loadPoleFigure_generic(fname,'HEADER',21,'degree',...
'ColumnNames',{'polar angle','azimuth angle','intensity'},...
'Columns',[1 2 3])
pf = PoleFigure (y↓→x)
  crystal symmetry : m-3m
 
  h = (111), r = 2120 x 1 points

state the crystal direction instead of guessing it from the file name

cs = crystalSymmetry('m-3m');
pf = loadPoleFigure_generic(fname,Miller(1,1,1,cs),'HEADER',21,'degree',...
'ColumnNames',{'polar angle','azimuth angle','intensity'},...
'Columns',[1 2 3])
pf = PoleFigure (y↓→x)
  crystal symmetry : m-3m
 
  h = (111), r = 2120 x 1 points

See also

PoleFigureImport PoleFigure.load

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