arrows on a map: one per grain at its centroid, per measurement, or per boundary segment at its midpoint

Syntax

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

A direction per grain.

quiver(ebsd, v, color='w')

An arrow per measurement.

quiver(gB, gB.direction, autoScaleFactor=0.5)

A needle per boundary segment.

quiver(grains, v, antipodal=True)

Axes, centred on the centroids.

quiver(grains, v, scale=10)

Scale times the length of v.

quiver(ebsd, v, maxHeadSize=0.2)

Heads a fifth of the longest arrow.

Description

A direction starts at its point, an axis (an antipodal vector, or antipodal=True) runs both ways from it. The default length depends on what carries the arrows:

  • grains: a fifth of the grain diameter along the direction in space, seen on the map, so that a direction steep to the map is short; an axis reaches that far to either side. A direction pointing into the map ends at the centroid unless projectIntoPlane=True.
  • a map: one and a half pixel spacings on the map for every arrow, whatever its inclination.
  • boundary segments: needles both ways from the midpoint, proportional to the length of the vector in space and seen on the map; autoScaleFactor, by default 0.15, sets their size relative to the spacing of the segments.

scale=s draws every arrow s times the length of its vector in the plane of the map instead, scaling=False at that length itself. Into a held map plot the arrows go on top of it, else into a map of their own.

Input

x grain2d, EBSD or grainBoundary
v vector3d, one per grain, measurement or segment

Keywords

keyword default description
scale None draw every arrow scale times its length in the plane of the map
color None the colour of the arrows; for grains by default the next of the axes’ colours
lineWidth None the width of the arrows
scaling True scale the arrows to the automatic length; False draws them at their own length
displayName None the name in a legend
autoScaleFactor None a factor on the automatic length
projectIntoPlane False let the arrow of a grain start at its centroid even when its direction points into the map, where it would otherwise end there
antipodal False draw the vectors as axes, centred on their points
maxHeadSize None the length of the heads as a fraction of the longest arrow, MATLAB’s MaxHeadSize; by default matplotlib’s heads

Output

h the matplotlib quiver or line collection

See also

grain2d.plot, EBSD.plot, Annotations

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