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, *, 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, default: 'b'` Цвет маркера. Возможные значения: Строка формата одного цвета. Последовательность спецификаций цветов длиной n. Последовательность n чисел, которые будут отображаться в цветах с помощью cmap и norm. Двумерный массив, в котором строки представляют RGB или RGBA. Обратите внимание, что c не должен быть одиночной числовой последовательностью RGB или RGBA, так как это неотличимо от массива значений, подлежащих отображению в цветах. Если вы хотите указать одно и то же значение RGB или RGBA для всех точек, используйте двумерный массив с одной строкой. В противном случае, сопоставление значений будет иметь приоритет в случае совпадения размеров с x и y. `marker : MarkerStyle, optional, default: 'o'` Стиль маркера. marker может быть экземпляром класса или текстовым сокращением для конкретного маркера. Более подробную информацию о стилях маркеров см. в `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 : color or sequence of color, optional, default: 'face'` Цвет границ маркера. Возможные значения: 'face': Цвет границы всегда будет таким же, как и цвет заливки. 'none': Граница элемента не будет нарисована. Цвет Matplotlib. Для маркеров без заливки аргумент edgecolors игнорируется и устанавливается как 'face' в процессе обработки.
Возвращает:	`paths : PathCollection`
Другие параметры:	`**kwargs : Collection properties`

См. также

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

Примечания

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

Примечание

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