Spec-Zone.ru › Matplotlib 3.0

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

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

../../_images/sphx_glr_scatter_piecharts_thumb.png

Диаграмма рассеяния с маркерами в виде круговых диаграмм

../../_images/sphx_glr_polar_scatter_thumb.png

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

../../_images/sphx_glr_scatter_thumb.png

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

© 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

Spec-Zone.ru

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