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 (пункт типографический равен 1/72 дюйма). По умолчанию rcParams['lines.markersize'] ** 2.

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

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

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

Обратите внимание, что c не должен быть единственной числовой последовательностью RGB или RGBA, потому что это неразличимо с массивом значений, подлежащих цветовому отображению. Если вы хотите указать одно и то же значение RGB или RGBA для всех точек, используйте 2D массив с одной строкой. В противном случае сопоставление значений будет иметь преимущество в случае соответствия размеров с 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 или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.

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

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

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

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

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

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

Возвращаемое значение:

PathCollection

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

См. также

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

Примечания

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