directions or crystal directions drawn as markers on a spherical plot, coloured by data or labelled

Syntax

scatter(v)

The directions as markers.

scatter(v, data, colorbar=True)

Coloured by values, with a colour bar.

scatter(v, rgb)

An RGB colour per direction.

scatter(v, label=texts)

A text below every marker.

scatter(v, label=texts, textAboveMarker=True)

The text above.

scatter(v, numbered=True)

Every direction labelled 1, 2, …, n.

scatter(h, symmetrised=True, labeled=True)

Every equivalent, named by its indices.

scatter(v, marker='s', markerSize=8, markerFaceColor='r', markerEdgeColor='k')

The markers styled.

scatter(v, data, minmax=True)

The smallest and largest value marked.

scatter(ori)

Orientations in axis angle space.

scatter(x, y, 50, 'r')

Points of two coordinate lists on the current map.

Description

The plot is new, or the one held; its projection, hemisphere and region follow the frame and the keywords of the spherical plots (upper, lower, fundamentalRegion, …). A Miller direction or plane with symmetrised=True is drawn at all its distinct symmetric equivalents. Orientations go to scatter3d’s axis angle space, two lists of coordinates to the map held.

Input

`v`	vector3d or Miller
`data`	one value per direction, or an (n, 3) array of RGB colours
`ori`	orientation
`x, y`	the coordinates of points on a map

Keywords

keyword	default	description
`minmax`	`False`	mark the smallest and the largest value
`symmetrised`	`False`	draw every distinct symmetric equivalent of a crystal direction
`colorbar`	`False`	add a colour bar for the data
`numbered`	`False`	label the directions by their number, 1 to n, in their order

Output

`h`	the matplotlib collections, one per spherical plot

Used on

EBSDOrientationPlots, ClusterDemo, BoundaryIntersections, TwinningBoundaries, Annotations, CombinedPlots, PlotTypes, RotationPlotting, S2FunApproximationInterpolation, S2FunSampling, VectorsImport, VectorsOperations

MATLAB’s quaternion.scatter

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/quaternion.scatter_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.

quaternion.scatter