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 для всех точек, используйте двумерный массив с одной строкой. В противном случае сопоставление значений будет иметь приоритет в случае совпадения размера с x и y.
-
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. -
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 лежат 1-мерные массивы; x, y, s и c могут быть введены как 2-мерные массивы, но внутри scatter они будут приведены к 1-мерным. Исключением является c, которое будет приведено к 1-мерному только если его размер соответствует размеру x и y.
Примечание
В дополнение к описанным выше аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:
- Все аргументы с следующими именами: 'c', 'color', 'edgecolors', 'facecolor', 'facecolors', 'linewidths', 's', 'x', 'y'.
Объекты, переданные как data, должны поддерживать доступ к элементам (
data[<arg>]) и проверку на принадлежность (<arg> in data). -
Примеры использования matplotlib.axes.Axes.scatter
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.0.0/api/_as_gen/matplotlib.axes.Axes.scatter.html