Syntax

scatter3d(v)

The directions on the sphere.

scatter3d(v, data, colorbar=True)

Coloured by a value each, with a colour bar.

scatter3d(v, label='a', color='r')

Red markers with a text beside them.

Description

The markers sit just outside the unit sphere, which is drawn first with its grid and the axes of the frame when the axes are new. An antipodal vector is drawn with its antipode. plot3d(v) of directions is the same.

Input

`v`	vector3d, the directions, normalised for drawing

Keywords

keyword	default	description
`data`	`None`	one value per direction, the colour of its marker
`markerSize`	`6`	the size of the markers in points
`color`	`(0.0, 0.447, 0.741)`	the colour of the markers without data
`colormap`	`'viridis'`	the colour map of the data
`colorRange`	`None`	(lo, hi), the values of the ends of the colour map; by default the range of the data
`grid`	`True`	draw the parallels and meridians on a new sphere
`axisLabels`	`True`	draw the axes of the frame on a new sphere
`label`	`None`	a text beside every marker, one for all or a list with one per direction
`colorbar`	`False`	add a colour bar of the data

Output

`h`	the matplotlib Path3DCollection of the markers

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/vector3d.scatter3d_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.

vector3d.scatter3d

Syntax

Description

Input

Keywords

Output

See also