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

Точечный график y против x с изменяемым размером и/или цветом маркеров.

Параметры:	`x, y : array_like, shape (n, )` Позиции данных. `s : scalar or array_like, shape (n, ), optional` Размер маркера в точках2. По умолчанию `rcParams['lines.markersize'] 2`. `c : color, sequence, or sequence of color, optional` Цвет маркера. Возможные значения: Строка формата одного цвета. Последовательность спецификаций цвета длиной n. Последовательность n чисел, которые будут отображаться в цветах с помощью cmap и norm. Двумерный массив, в котором строки представляют RGB или RGBA. Обратите внимание, что c не должен быть единственной числовой последовательностью RGB или RGBA, так как это неотличимо от массива значений для отображения цветов. Если вы хотите указать одно и то же значение RGB или RGBA для всех точек, используйте двумерный массив с одной строкой. В противном случае сопоставление значений будет иметь приоритет в случае соответствия размера с x и y. По умолчанию `None`. В этом случае цвет маркера определяется значением `color`, `facecolor` или `facecolors`. Если они не указаны или `None`, цвет маркера определяется следующим цветом текущего цикла цветов "фигуры и заливки". Этот цикл по умолчанию `rcParams["axes.prop_cycle"]`. `marker : MarkerStyle, optional` Стиль маркера. marker может быть экземпляром класса или текстовым сокращением для конкретного маркера. По умолчанию `None`, в этом случае он принимает значение `rcParams["scatter.marker"]` = 'o'. См. `markers` для получения дополнительной информации о стилях маркеров. `cmap : Colormap, optional, default: None` Экземпляр `Colormap` или зарегистрированное имя цветовой карты. cmap используется только в том случае, если c представляет собой массив чисел с плавающей точкой. Если `None`, по умолчанию rc `image.cmap`. `norm : Normalize, optional, default: None` Экземпляр `Normalize` используется для масштабирования данных яркости до 0, 1. norm используется только в том случае, если c представляет собой массив чисел с плавающей точкой. Если None, используется значение по умолчанию `colors.Normalize` `vmin, vmax : scalar, optional, default: None` vmin и vmax используются совместно с norm для нормализации данных яркости. Если None, используются минимальное и максимальное значения массива цветов. vmin и vmax игнорируются, если вы передаете экземпляр norm. `alpha : scalar, optional, default: None` Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). `linewidths : scalar or array_like, optional, default: None` Толщина линии границ маркера. Примечание: по умолчанию edgecolors — 'face'. Возможно, вам захочется это изменить. Если None, по умолчанию rcParams `lines.linewidth`. `edgecolors : {'face', 'none', None} or color or sequence of color, optional.` Цвет границ маркера. Возможные значения: 'face': Цвет границы всегда будет совпадать с цветом заливки. 'none': Границы области не будут отрисовываться. Цвет Matplotlib или последовательность цветов. По умолчанию `None`, в этом случае он принимает значение `rcParams["scatter.edgecolors"]` = 'face'. Для маркеров без заливки аргумент edgecolors игнорируется и принудительно устанавливается в 'face' внутри функции. `plotnonfinite : boolean, optional, default: False` Устанавливает отрисовку точек с неопределённым c в сочетании с `set_bad`.
Возвращает:	`paths : PathCollection`
Другие параметры:	`**kwargs : Collection properties`

См. также

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

Примечания

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

Примечание

Помимо перечисленных аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]: