scatter#

Orientation.scatter(projection: Literal['axangle', 'rodrigues', 'homochoric', 'ipf'] = 'axangle', figure: Figure | None = None, position: int | tuple[int, int, int] | SubplotSpec | None = None, return_figure: bool = False, wireframe_kwargs: dict | None = None, size: int | None = None, direction: Vector3d | None = None, figure_kwargs: dict | None = None, **kwargs) Figure | None[source]#

Plot misorientations in 3D Euclidean space using either a 3D neo-Eulerian projection or a 2D stereographic projection.

Parameters:
projection

Which projection to use for plotting into Euclidean space. The 3D options are “axangle” (default) for a linear scaling, “homochoric” for an equal-volume scaling, or “rodrigues” for a rectilinear scaling. The 2D option is “ipf” to give an inverse pole figure.

figure

If given, a new plot axis with the projection specified by projection is added to the figure in the position specified by position. If not given, a new figure is created.

position

Where to add the new plot axis. 121 or (1, 2, 1) places it in the first of two positions in a grid of 1 row and 2 columns. See add_subplot() for further details. If not given, the default position of (1, 1, 1) is assumed.

return_figure

Whether to return the figure. Default is False.

wireframe_kwargs

Keyword arguments passed to plot_wireframe() or equivalent. Unused if projection is “ipf”.

size

If not given, all orientations are plotted. If given, a random sample of this size of the orientations is plotted.

direction

Sample direction to plot with respect to crystal directions. If not given, the out of plane direction, sample Z, is used. Only used when plotting inverse pole figures.

figure_kwargs

Dictionary of keyword arguments passed to matplotlib.pyplot.figure() if figure is not given.

**kwargs

Keyword arguments passed to the orix plotting class set by position.

Returns:
figure

Figure with the added plot axis, if return_figure is True.

Examples using Orientation.scatter#

Color scatter plots

Color scatter plots

Visualizing orientations

Visualizing orientations