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

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

Параметры:	x, yfloat или array-like, форма (n, ) Позиции данных. sfloat или array-like, форма (n, ), необязательно Размер маркера в пунктах2. По умолчанию `rcParams['lines.markersize'] 2`. carray-like или список цветов или цвет, необязательно Цвета маркеров. Возможные значения: Скаляр или последовательность из n чисел, которые будут отображаться в цвета с помощью cmap и norm. Двумерный массив, в котором строки — это значения RGB или RGBA. Последовательность цветов длиной n. Строка формата одного цвета. Обратите внимание, что c не должен быть одиночным числовым значением RGB или RGBA, так как это неотличимо от массива значений, подлежащих цветовому отображению. Если вы хотите указать одно и то же значение RGB или RGBA для всех точек, используйте двумерный массив с одной строкой. В противном случае, сопоставление значений будет иметь приоритет в случае соответствия размера с x и y. Если вы хотите указать один цвет для всех точек, используйте ключевое слово color. По умолчанию `None`. В этом случае цвет маркера определяется значением color, facecolor или facecolors. Если они не указаны или `None`, цвет маркера определяется следующим цветом в текущем цикле цветов формы и заливки. Этот цикл по умолчанию `rcParams["axes.prop_cycle"]` (по умолчанию `cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])`). marker`MarkerStyle`, по умолчанию: `rcParams["scatter.marker"]` (по умолчанию: `'o'`) Стиль маркера. marker может быть экземпляром класса или текстовым сокращением для определенного маркера. См. `matplotlib.markers` для получения дополнительной информации о стилях маркеров. cmapстрока или `Colormap`, по умолчанию: `rcParams["image.cmap"]` (по умолчанию: `'viridis'`) Экземпляр `Colormap` или имя зарегистрированной цветовой карты. cmap используется только в том случае, если c — массив чисел с плавающей точкой. norm`Normalize`, по умолчанию: None Если c — массив чисел с плавающей точкой, norm используется для масштабирования данных цвета, c, в диапазоне от 0 до 1, чтобы отобразить их в цветовой карте cmap. Если None, используется по умолчанию `colors.Normalize`. vmin, vmaxfloat, по умолчанию: None vmin и vmax используются совместно с по умолчанию нормой для отображения массива цветов c в цветовой карте cmap. Если None, используются минимальное и максимальное значения массива цветов. Использование vmin/vmax при заданном norm устарело. alphafloat, по умолчанию: None Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). linewidthsfloat или array-like, по умолчанию: `rcParams["lines.linewidth"]` (по умолчанию: `1.5`) Толщина линий границ маркера. Примечание: По умолчанию edgecolors — 'face'. Возможно, вам захочется это изменить. edgecolors{'face', 'none', None} или цвет или последовательность цветов, по умолчанию: `rcParams["scatter.edgecolors"]` (по умолчанию: `'face'`) Цвет границ маркера. Возможные значения: 'face': Цвет границы всегда совпадает с цветом заливки. 'none': Граница маркера не рисуется. Цвет или последовательность цветов. Для маркеров без заливки edgecolors игнорируется. Вместо этого цвет определяется, как и с 'face', т.е. из c, colors или facecolors. plotnonfinitebool, по умолчанию: False Рисовать ли точки с нечисловыми значениями c (т.е. `inf`, `-inf` или `nan`). Если `True` точки рисуются цветом bad цветовой карты (см. `Colormap.set_bad`).
Возвращает:	`PathCollection`
Другие параметры:	**kwargs`Collection` свойства

См. также

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

Примечания

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

Примечание

В дополнение к описанным выше параметрам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы могут быть строками s, которые интерпретируются как data[s] (если это не приводит к исключению): x, y, s, linewidths, edgecolors, c, facecolor, facecolors, color.