the ODF a file holds, the interface told by its content: a VPSC texture file or a generic table; MATLAB’s SO3Fun.load, loadODF_generic and loadODF_VPSC

Syntax

odf = loadODF('TEX_PH1.OUT', cs)

A VPSC texture file.

odf = loadODF('TEX_PH1.OUT', cs, halfwidth=5*degree)

Its densities with another kernel.

odf = loadODF('odf.txt', CS=cs, columnNames=['phi1', 'Phi', 'phi2', 'value'])

A function through the values of a table.

odf = loadODF('ori.txt', cs, 'density', halfwidth=10*degree)

Kernels centred at the orientations of a table.

Description

The content decides the interface:

  • ‘VPSC’: a file whose fourth line names a convention letter (B, K or R) and a count. Every block of weighted orientations becomes one density, calcDensity with the weights, a list of them for several blocks. The strain, the ellipsoid, the orientations and the further columns are kept in odf.opt. The file names no crystal frame, so it is cubic unless given.
  • ‘generic’: a table of Euler angles and one more column; it needs the crystal frame.

A generic table is read as one of two kinds. ‘interp’ fits a function through the values (interpolate, with bandwidth, lambda_, maxIter and tol); ‘density’ centres kernels of those masses (halfwidth, resolution). Without either, varying values mean ‘interp’ and equal ones ‘density’.

The angles of a table are degrees when one exceeds 15, unless radians=True. columnNames name the columns and columns place them, counted from 0 where MATLAB counts from 1; ‘Bunge’ (the default), ‘ZYZ’, … give the convention. The crystal frame is passed positionally or as CS=, the specimen frame as SS=.

Input

fname the name of the file

Keywords

keyword default description
interface None ‘VPSC’ or ‘generic’, which the content decides when not given; the other keywords go to the reader of the interface

Output

odf an SO3Fun, or a list of them for a VPSC file of several blocks

See also

exportODF, calcDensity, interpolate, loadOrientation

MATLAB’s loadODF_VPSC

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