Homochoric.scatter(projection: str = 'stereographic', figure: Figure | None = None, axes_labels: List[str] | None = None, vector_labels: ndarray | List[str] | None = None, hemisphere: str | None = None, reproject: bool = False, show_hemisphere_label: bool | None = None, grid: bool | None = None, grid_resolution: Tuple[float, float] | None = None, figure_kwargs: Dict | None = None, reproject_scatter_kwargs: Dict | None = None, text_kwargs: Dict | None = None, return_figure: bool = False, **kwargs: Any) Figure | None[source]#

Plot vectors in the stereographic projection.


Which projection to use. The default is "stereographic", the only current option.


Which figure to plot onto. Default is None, which creates a new figure.


Reference frame axes labels, defaults to [None, None, None].


Labels for each vector. None are added if not given. Their offsets in stereographic coordinates (X, Y) can be controlled by passing offset to text_kwargs.


Which hemisphere(s) to plot the vectors in, defaults to None, which means "upper" if a new figure is created, otherwise adds to the current figure’s hemispheres. Options are "upper", "lower", and "both", which plots two projections side by side.


Whether to reproject vectors onto the chosen hemisphere. Reprojection is achieved by reflection of the vectors located on the opposite hemisphere in the projection plane. Ignored if hemisphere is "both". Default is False.


Whether to show hemisphere labels "upper" or "lower". Default is True if hemisphere is "both", otherwise False.


Whether to show the azimuth and polar grid. Default is whatever axes.grid is set to in matplotlib.rcParams.


Azimuth and polar grid resolution in degrees, as a tuple. Default is whatever is default in stereographic_grid.


Dictionary of keyword arguments passed to matplotlib.pyplot.subplots().


Dictionary of keyword arguments for the reprojected scatter points which is passed to scatter(), which passes these on to matplotlib.axes.Axes.scatter(). The default marker style for reprojected vectors is "+". Values used for vector(s) on the visible hemisphere are used unless another value is passed here.


Dictionary of keyword arguments passed to text(), which passes these on to matplotlib.axes.Axes.text().


Whether to return the figure (default is False).


Keyword arguments passed to scatter(), which passes these on to matplotlib.axes.Axes.scatter().


The created figure, returned if return_figure=True.


This is a somewhat customizable convenience method which creates a figure with axes using StereographicPlot, however, it is meant for quick plotting and prototyping. This figure and the axes can also be created using Matplotlib directly, which is more customizable.