the directions a text table holds, read by the names of its coordinate columns, and the other columns it names

Syntax

v, S = loadVector3d('vectors.txt')

The names on the line above the numbers.

v, S = loadVector3d('vectors.txt', columnNames=['polar angle', 'azimuth angle'])

Polar angles in degrees.

v, S = loadVector3d('vectors.txt', columnNames=['x', 'y', 'z', 'weight'])

Cartesian, with a weight in S.

v, S = loadVector3d('vectors.txt', columnNames=['latitude', 'longitude'], columns=[1, 0])

The columns the names sit in.

v = vector3d.load('vectors.txt')

The directions alone.

Description

The coordinates are x, y, z, kept at their length, or two angles read as unit directions: the polar angle (colatitude) from z and the azimuth (longitude) in the xy plane, or the latitude from the xy plane and the longitude. A name is matched without regard to case. Every other named column comes back in S, a dict of one array per name.

Without columnNames the last header line names the columns, when it names coordinates; the header ends at the first row of numbers.

Input

fname str, the name of a text file

Keywords

keyword	default	description
`columnNames`	`None`	the names of the columns, in their order in the file or in columns
`columns`	`None`	the positions of the named columns, counted from zero
`radians`	`False`	the angles are in radians, not degrees
`delimiter`	`None`	the delimiter between the numbers, blank space by default
`header`	`None`	the number of header lines, found from the first row of numbers by default

Output

`v`	vector3d, the directions
`S`	dict, the columns that are not coordinates, by name

Used on

S2FunApproximationInterpolation, VectorsExport

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

loadVector3d