add_scatter#
- Subplot.add_scatter(data, colors='w', uniform_color=False, alpha=1.0, cmap=None, cmap_transform=None, isolated_buffer=True, sizes=1, uniform_size=False, size_space='screen', **kwargs)#
Create a Scatter Graphic, 2d or 3d
- Parameters:
data (array-like) – Scatter data to plot, Can provide 2D, or a 3D data. 2D data must be of shape [n_points, 2]. 3D data must be of shape [n_points, 3]
colors (str, array, tuple, list, Sequence, default "w") – specify colors as a single human-readable string, a single RGBA array, or a Sequence (array, tuple, or list) of strings or RGBA arrays
uniform_color (bool, default False) – if True, uses a uniform buffer for the scatter point colors. Useful if you need to save GPU VRAM when all points have the same color.
alpha (float, optional, default 1.0) – alpha value for the colors
cmap (str, optional) – apply a colormap to the scatter instead of assigning colors manually, this overrides any argument passed to “colors”. For supported colormaps see the
cmap
library catalogue: https://cmap-docs.readthedocs.io/en/stable/catalog/cmap_transform (1D array-like or list of numerical values, optional) – if provided, these values are used to map the colors from the cmap
isolated_buffer (bool, default True) – whether the buffers should be isolated from the user input array. Generally always
True
,False
is for rare advanced use if you have large arrays.sizes (float or iterable of float, optional, default 1.0) – sizes of the scatter points
uniform_size (bool, default False) – if True, uses a uniform buffer for the scatter point sizes. Useful if you need to save GPU VRAM when all points have the same size.
size_space (str, default "screen") – coordinate space in which the size is expressed (“screen”, “world”, “model”)
kwargs – passed to Graphic
- Return type: