orientations written to a text file, as a table of Euler angles or quaternions with further columns, or as a VPSC texture file; export(ori, fname) calls it

Syntax

export(ori, fname)

Bunge Euler angles in degree.

export(ori, fname, 'Matthies', radians=True)

Another convention, in radians.

export(ori, fname, quaternion=True)

The four quaternion components.

export(ori, fname, {'area': grains.area})

Further columns.

export(ori, fname, 'Bunge', interface='VPSC', weights=w)

The VPSC texture file.

Description

The table has one row per orientation, the columns named in a header line: phi1, Phi, phi2 for Bunge, alpha, beta, gamma for Matthies and ZYZ, Psi, Theta, Phi for Roe, Psi, Theta, phi for Kocks, or a, b, c, d; every entry of a dictionary among the arguments adds a column, as MATLAB’s struct does. loadOrientation reads it back. The VPSC file, MATLAB’s export_VPSC, has four header lines and the weights, normalised to sum to one, in the fourth column; it takes the conventions Bunge, Kocks and Roe.

Input

ori orientation
fname the name of the file
args the Euler convention, ‘Bunge’, ‘Matthies’, ‘ZYZ’, ‘Roe’ or ‘Kocks’, and dictionaries of further columns, one value per orientation

Keywords

keyword default description
radians False the angles in radians instead of degree
quaternion False the quaternion components instead of Euler angles
interface None None for the table, ‘VPSC’ for the VPSC texture file
weights None the weights of the orientations in the VPSC file, equal by default

See also

loadOrientation, export, quaternion.Euler

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