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, ), необязательно

Размер маркера в точках**2. По умолчанию 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 (по умолчанию 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 или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.

Этот параметр игнорируется, если c является RGB(A).

normстрока или Normalize, необязательно

Метод нормализации, используемый для масштабирования скалярных данных до диапазона [0, 1] перед сопоставлением с цветами с использованием cmap. По умолчанию используется линейное масштабирование, сопоставляющее наименьшее значение с 0, а наибольшее — с 1.

Если задано, это может быть одно из следующего:

Экземпляр Normalize или один из его подклассов (см. Нормализация цветовой карты).
Имя масштаба, например, "линейный", "логарифмический", "симлогарифмический", "логит" и т.д. Для получения списка доступных масштабов вызовите matplotlib.scale.get_scale_names(). В этом случае подходящий подкласс Normalize динамически генерируется и создается.

Этот параметр игнорируется, если c является RGB(A).

vmin, vmaxfloat, необязательно

При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который охватывает цветовая карта. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. Использование vmin/vmax при указании экземпляра norm является ошибкой (но использование имени norm вместе с vmin/vmax допустимо).

Этот параметр игнорируется, если c является RGB(A).

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

**kwargsCollection свойства

См. также

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

Примечания

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