the orientations a text table holds, and the other columns it names

Syntax

ori, S = loadOrientation('ori.txt', cs)

The columns named in the header.

ori, S = loadOrientation('ori.txt', cs, columnNames=['phi1', 'Phi', 'phi2', 'weight'])

The names given.

ori, S = loadOrientation('ori.txt', cs, columnNames=['phi1', 'Phi', 'phi2'], columns=[3, 1, 6])

Where they sit.

ori, S = loadOrientation('ori.txt', cs, columnNames=['Quat real', 'Quat i', 'Quat j', 'Quat k'])

Quaternions.

Description

The columns are named by columnNames or by the last header line; three of them have to be Euler angles, phi1, Phi, phi2 or Euler 1, Euler 2, Euler 3 (Bunge) or alpha, beta, gamma (Matthies), or the four quaternion components. The other named columns come back in the dictionary S, under their names without blanks. A .csv file is separated by commas.

Input

fname the name of the file
CS crystalFrame, by default the triclinic one
SS specimenFrame, by default the default specimen frame

Keywords

keyword default description
columnNames None the names of the columns, instead of the header line
columns None the zero based columns the names refer to
radians False the Euler angles are in radians instead of degree
delimiter None the separator of the columns, by default blank space
header None the number of header lines, by default the lines before the first row of numbers
passive False the angles describe the passive rotation, which is inverted

Output

ori orientation
S dict of the other columns, one array each

See also

exportOrientation, loadEBSD, loadODF, orientation.byEuler, OrientationImport

Used on

HarmonicApproximationTheory, RBFApproximationTheory, SO3FunApproximationTheory

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