A method of grain2d.

arrows: tangent vectors at directions, a vector or axis field on the sphere, arrows at orientations in the sections of the current figure, or directions on a map or a volume; MATLAB’s vector3d.quiver, S2VectorField.quiver and EBSD.quiver

Syntax

quiver(v, w)

The tangent vectors w at the directions v.

quiver(v, w, arrowSize=1, color='r')

Longer arrows, in red.

quiver(v, w, normalize=True, maxHeadSize=0.3)

All of one length, with larger heads.

quiver(vF)

A vector field on an equispaced grid.

quiver(vF, resolution=5*degree)

On a finer grid.

quiver(ebsd, ebsd.rotations.axis(), color='r')

An arrow per measurement of a map.

quiver(ebsd, ebsd.rotations.axis(), antipodal=True)

Axes, centred on the measurements.

quiver(grains, grains.meanOrientation * Miller(1, 0, 0, grains.CS, 'uvw'))

An arrow per grain.

quiver(gB, gB.direction)

A needle per boundary segment.

Description

What the first argument is decides where the arrows go:

  • directions or a vector or axis field: arrows on the sphere, a field on an equispaced grid of the spacing resolution.
  • orientations: arrows in the ODF sections of the current figure.
  • a map, its grains or its boundaries: an arrow per measurement, grain or segment on the map plot, with the keywords scale, scaling, autoScaleFactor, projectIntoPlane, antipodal, color, lineWidth and displayName.
  • a map of volumes or 3D grains: arrows in the scene of its figure.

On the sphere an arrow is the tangential part of w at its direction, so a vector almost normal to the sphere draws almost nothing. The longest vector of all is arrowSize times the spacing resolution; normalize=True draws every arrow at that length. An antipodal w, or an axis field, draws centred needles without heads.

maxHeadSize is the length of the heads as a fraction of the longest arrow, lineWidth the width of the shafts, color their colour; the projection and the charts follow the keywords of the spherical plots.

Input

v vector3d, the points of the arrows; an S2VectorField or S2AxisField; orientation; EBSD, grain2d or grainBoundary; EBSD3 or grain3d
w vector3d, the arrows, one per point of v

Keywords

keyword default description
resolution 10*degree the spacing of the grid a field is drawn on, and the length unit of the arrows on the sphere

Output

h the matplotlib quiver or line collections, one per spherical plot

See also

plot, scatter, S2VectorField, grain2d.plot, SphericalProjections

MATLAB’s grain2d.quiver

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/grain2d.quiver_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.