matplotlib.axes.Axes.scatter
-
Axes.scatter(x, y, s=None, c=None, marker=None, cmap=None, norm=None, vmin=None, vmax=None, alpha=None, linewidths=None, verts=None, edgecolors=None, *, data=None, **kwargs)[source] -
Диаграмма рассеяния y по x с изменяющимся размером и/или цветом маркеров.
Параметры: -
x, y : array_like, shape (n, ) -
Позиции данных.
-
s : scalar or array_like, shape (n, ), optional -
Размер маркера в точках**2. По умолчанию
rcParams['lines.markersize'] ** 2. -
c : color, sequence, or sequence of color, optional, default: 'b' -
Цвет маркера. Возможные значения:
- Единственный формат строки цвета.
- Последовательность спецификаций цветов длиной n.
- Последовательность n чисел, которые будут сопоставлены с цветами с помощью cmap и norm.
- Двумерный массив, в котором строки — RGB или RGBA.
Обратите внимание, что c не должен быть одиночной числовой RGB или RGBA последовательностью, так как это неразличимо от массива значений, которые нужно отобразить в цвете. Если вы хотите указать одно и то же значение RGB или RGBA для всех точек, используйте двумерный массив с одной строкой.
-
marker : MarkerStyle, optional, default: 'o' -
Стиль маркера. marker может быть экземпляром класса или текстовым сокращением для определённого маркера. Для получения дополнительной информации о стилях маркеров см.
markers. -
cmap : Colormap, optional, default: None -
Экземпляр
Colormapили зарегистрированное имя цветовой карты. cmap используется только если c — массив чисел с плавающей точкой. ЕслиNone, по умолчанию используется rcimage.cmap. -
norm : Normalize, optional, default: None -
Экземпляр
Normalizeиспользуется для масштабирования данных яркости до 0, 1. norm используется только если c — массив чисел с плавающей точкой. Если None, используется по умолчаниюcolors.Normalize. -
vmin, vmax : scalar, optional, default: None -
vmin и vmax используются совместно с norm для нормализации данных яркости. Если None, используются соответствующие минимальное и максимальное значения массива цветов. vmin и vmax игнорируются, если вы передали экземпляр norm.
-
alpha : scalar, optional, default: None -
Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный).
-
linewidths : scalar or array_like, optional, default: None -
Ширина линии границ маркера. Обратите внимание: по умолчанию edgecolors — 'face'. Возможно, вам захочется это изменить. Если None, по умолчанию используется rcParams
lines.linewidth. -
verts : sequence of (x, y), optional -
Если marker — None, эти вершины будут использованы для построения маркера. Центр маркера находится в (0, 0) в нормированных единицах. Маркер в целом масштабируется с помощью s.
-
edgecolors : color or sequence of color, optional, default: 'face' -
Цвет обводки маркера. Возможные значения:
- 'face': Цвет обводки всегда будет таким же, как и цвет заливки.
- 'none': Граница фигуры не будет нарисована.
- Цвет Matplotlib.
Для маркеров без заливки аргумент edgecolors игнорируется и внутренне принудительно устанавливается в 'face'.
Возвращает: -
paths : PathCollection
Другие параметры: -
**kwargs : Collection properties
См. также
-
plot - Для построения диаграмм рассеяния, когда маркеры имеют одинаковый размер и цвет.
Примечания
- Функция
plotбудет работать быстрее для диаграмм рассеяния, где маркеры не изменяются по размеру или цвету. - Любые или все из x, y, s и c могут быть масками, в этом случае все маски будут объединены, и будут нарисованы только точки без маски.
- В основе scatter лежат одномерные массивы; x, y, s и c могут быть введены как двумерные массивы, но внутри scatter они будут сглажены. Исключением является c, который будет сглажен только в том случае, если его размер соответствует размеру x и y.
Примечание
В дополнение к вышеописанным аргументам, эта функция может принять аргумент data. Если такой аргумент data задан, следующие аргументы заменятся на data[<arg>]:
- Все аргументы со следующими именами: 'c', 'color', 'edgecolors', 'facecolor', 'facecolors', 'linewidths', 's', 'x', 'y'.
-
Примеры использования matplotlib.axes.Axes.scatter
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/_as_gen/matplotlib.axes.Axes.scatter.html