Spec-Zone.ru › Matplotlib 2.2

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, по умолчанию используется rc image.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

../../_images/sphx_glr_scatter_thumb.png

Диаграмма рассеяния

../../_images/sphx_glr_polar_scatter_thumb.png

Диаграмма рассеяния на полярной оси

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API