matplotlib.axes.Axes.scatter

Axes.scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None, vmin=None, vmax=None, alpha=None, linewidths=None, verts=None, edgecolors=None, *, plotnonfinite=False, 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 Цвет маркера. Возможные значения: Единая строка формата цвета. Последовательность спецификаций цвета длиной n. Последовательность n чисел, которые будут сопоставлены с цветами с помощью cmap и norm. Двумерный массив, в котором строки — RGB или RGBA. Обратите внимание, что c не должен быть одиночной числовой последовательностью RGB или RGBA, потому что это неотличимо от массива значений, которые нужно отобразить в цветовой шкале. Если вы хотите указать одно и то же значение RGB или RGBA для всех точек, используйте двумерный массив с одной строкой. В противном случае соответствие значений будет иметь приоритет в случае соответствия размера с x и y. По умолчанию None. В этом случае цвет маркера определяется значением color, facecolor или facecolors. Если эти значения не указаны или None, цвет маркера определяется следующим цветом в текущей цветовой палитре Axes для "заливки и контура". Эта палитра по умолчанию rcParams["axes.prop_cycle"]. marker : MarkerStyle, optional Стиль маркера. marker может быть экземпляром класса или текстовым сокращением для определенного маркера. По умолчанию None, в этом случае он принимает значение rcParams["scatter.marker"] = 'o'. Смотрите 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 : {'face', 'none', None} or color or sequence of color, optional. Цвет границ маркера. Возможные значения: 'face': Цвет границы всегда будет таким же, как цвет заливки. 'none': Граница объекта не будет отрисована. Цвет Matplotlib или последовательность цветов. По умолчанию None, в этом случае он принимает значение rcParams["scatter.edgecolors"] = 'face'. Для маркеров без заливки аргумент edgecolors игнорируется и принудительно устанавливается в 'face' внутри функции. plotnonfinite : boolean, optional, default: False Устанавливается для отображения точек с нечисловыми значениями c в сочетании с set_bad.
Возвращает:	paths : PathCollection
Другие параметры:	**kwargs : Collection properties

См. также

plot

Для построения диаграмм рассеяния, где маркеры одинаковы по размеру и цвету.

Примечания

• Функция plot будет быстрее для диаграмм рассеяния, где маркеры не изменяются по размеру или цвету.
• Любые или все из x, y, s и c могут быть масками массивов, в этом случае все маски будут объединены, и будут отображаться только точки без маски.
• В основе scatter лежат 1-мерные массивы; x, y, s и c могут быть введены как 2-мерные массивы, но внутри scatter они будут сглажены. Исключением является c, который будет сглажен только в том случае, если его размер соответствует размеру 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

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

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

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

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