matplotlib.pyplot.scatter

matplotlib.pyplot.scatter(x, y, s=None, c=None, *, marker=None, cmap=None, norm=None, vmin=None, vmax=None, alpha=None, linewidths=None, edgecolors=None, colorizer=None, plotnonfinite=False, data=None, **kwargs)[исходный код]

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

Параметры:

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

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

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

Размер маркера в пунктах**2 (типографский пункт равен 1/72 дюйма). Значение по умолчанию — rcParams['lines.markersize'] ** 2.

Толщина линии и цвет границы могут визуально взаимодействовать с размером маркера и приводить к артефактам, если размер маркера меньше толщины линии.

Если толщина линии больше 0, а цвет границы не равен 'none', эффективный размер маркера увеличится на половину толщины линии, поскольку обводка будет центрирована по краю фигуры.

Чтобы убрать границу маркера, задайте linewidth=0 или edgecolor='none'.

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

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

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

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

Если задан, этот параметр может принимать одно из следующих значений:

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

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

vmin, vmaxвещественное число, необязательно

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

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

alphaвещественное число, по умолчанию: None

Значение альфа-смешивания от 0 (прозрачный) до 1 (непрозрачный).

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

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

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

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

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

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

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

Объект Colorizer, используемый для сопоставления цвета с данными. Если задано значение None, объект Colorizer создаётся на основе norm и cmap.

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

plotnonfiniteлогическое значение, по умолчанию: False

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

Возвращает:

PathCollection

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

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

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

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

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

Свойство	Описание
agg_filter	функция фильтрации, принимающая массив float формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	массивоподобный объект, float или None
animated	bool
antialiased or aa or antialiaseds	bool или список значений bool
array	массивоподобный объект или None
capstyle	CapStyle или {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
cmap	Colormap или str или None
color	цвет или список кортежей RGBA
edgecolor or ec or edgecolors	цвет или список значений цвет или 'face'
facecolor or facecolors or fc	цвет или список значений цвет
figure	Figure или SubFigure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	неизвестно
in_layout	bool
joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
label	object
linestyle or dashes or linestyles or ls	str, кортеж или список таких значений
linewidth or linewidths or lw	float или список значений float
mouseover	bool
norm	Normalize или str или None
offset_transform or transOffset	Transform
offsets	массивоподобный объект формы (N, 2) или (2,)
path_effects	список объектов AbstractPathEffect
paths	неизвестно
picker	None, bool, float или вызываемый объект
pickradius	float
rasterized	bool
sizes	numpy.ndarray или None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	str
urls	список значений str или None
visible	bool
zorder	float

См. также

plot

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

Примечания

Примечание

Это обёртка pyplot для axes.Axes.scatter.

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

Примеры использования matplotlib.pyplot.scatter

Диаграмма рассеяния с маскированными значениями

Диаграмма рассеяния с маскированными значениями

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

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

Гиперссылки

Гиперссылки

Диаграмма рассеяния в полярной системе координат

Диаграмма рассеяния в полярной системе координат

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

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

Руководство по pyplot

Руководство по pyplot