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, *, edgecolors=None, plotnonfinite=False, data=None, **kwargs)[source]

Диаграмма рассеяния y по оси x с изменяющимся размером и/или цветом маркеров.

Параметры

x, yfloat или массив-подобный объект, форма (n, )

Позиции данных.

sfloat или массив-подобный объект, форма (n, ), необязательно

Размер маркера в точках². По умолчанию rcParams['lines.markersize'] ** 2.

cмассив-подобный объект, список цветов или цвет, необязательно

Цвета маркеров. Возможные значения:

Скаляр или последовательность n чисел, которые будут отображаться в цвета с помощью cmap и norm.
Двумерный массив, в котором строки представляют RGB или RGBA.
Последовательность цветов длиной n.
Строковое представление цвета.

Обратите внимание, что c не должен быть единственной числовой RGB или RGBA последовательностью, поскольку это неотличимо от массива значений для сопоставления с цветами. Если вы хотите указать одно и то же значение RGB или RGBA для всех точек, используйте двумерный массив с одной строкой. В противном случае сопоставление значений будет иметь преимущество в случае соответствия размера x и y.

Если вы хотите указать один цвет для всех точек, предпочтительнее использовать ключевое слово color.

По умолчанию None. В этом случае цвет маркера определяется значением color, facecolor или facecolors. В случае если они не заданы или None, цвет маркера определяется следующим цветом из цикла цветов Axes. Этот цикл по умолчанию равен rcParams["axes.prop_cycle"] (по умолчанию: cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])).

markerMarkerStyle, по умолчанию: rcParams["scatter.marker"] (по умолчанию: 'o')

Стиль маркера. marker может быть экземпляром класса или текстовым сокращением для конкретного маркера. См. matplotlib.markers для получения дополнительной информации о стилях маркеров.

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Экземпляр Colormap или зарегистрированное имя цветовой карты. cmap используется только в том случае, если c является массивом чисел с плавающей точкой.

normNormalize, по умолчанию: None

Если c является массивом чисел с плавающей точкой, norm используется для масштабирования данных цвета, c, в диапазоне от 0 до 1, чтобы отобразить их в цветовой карте cmap. Если None, используется значение по умолчанию colors.Normalize.

vmin, vmaxfloat, по умолчанию: None

vmin и vmax используются совместно с нормализацией по умолчанию для отображения массива цвета c в цветовой карте cmap. Если None, используется минимальное и максимальное значения массива цвета. Нельзя использовать vmin/vmax, когда задано norm.

alphafloat, по умолчанию: None

Значение прозрачности, от 0 (прозрачный) до 1 (непрозрачный).

linewidthsfloat или массив-подобный объект, по умолчанию: rcParams["lines.linewidth"] (по умолчанию: 1.5)

Толщина линий краев маркера. Обратите внимание: по умолчанию edgecolors равен 'face'. Возможно, вам захочется изменить это.

edgecolors{'face', 'none', None} или цвет или последовательность цветов, по умолчанию: rcParams["scatter.edgecolors"] (по умолчанию: 'face')

Цвет краев маркера. Возможные значения:

'face': цвет краев всегда будет таким же, как цвет заливки.
'none': граница фигуры не будет нарисована.
Цвет или последовательность цветов.

Для маркеров без заливки edgecolors игнорируется. Вместо этого цвет определяется так же, как с 'face', т.е. из c, colors или facecolors.

plotnonfinitebool, по умолчанию: False

Определяет, нужно ли строить точки с нечисловыми значениями c (т.е. inf, -inf или nan). Если True точки выводятся с цветом по цветовой карте bad (см. Colormap.set_bad).

Возвращает

PathCollection

Другие параметры

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения):

x, y, s, linewidths, edgecolors, c, facecolor, facecolors, color

**kwargsсвойства Collection

См. также

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

Примечания

Функция plot будет быстрее для диаграмм рассеяния, где маркеры не различаются по размеру или цвету.
Любые или все из x, y, s и c могут быть масками массивов, в этом случае все маски будут объединены, и будут построены только точки без масок.
В основе scatter лежат одномерные массивы; x, y, s и c могут быть введены как N-мерные массивы, но в scatter они будут сглажены. Исключением является c, которое будет сглажено только в том случае, если его размер соответствует размеру x и y.