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, 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')

Экземпляр цветовой карты или зарегистрированное имя цветовой карты, используемые для преобразования скалярных данных в цвета.

Этот параметр игнорируется, если 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).

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

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

Возвращает:

PathCollection

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

dataindexable object, optional

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

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

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

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

См. также

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

Примечания

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