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

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

Параметры:	`x, yfloat or array-like, shape (n, )` Позиции данных. `sfloat or array-like, shape (n, ), optional` Размер маркера в точках2. По умолчанию `rcParams['lines.markersize'] 2`. `carray-like or list of colors or color, optional` Цвета маркеров. Возможные значения: Скалярное значение или последовательность из 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, default: rcParams["scatter.marker"] (default: 'o')` Стиль маркера. marker может быть экземпляром класса или текстовым сокращением для определенного маркера. См. `matplotlib.markers` для получения дополнительной информации о стилях маркеров. `cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis')` Экземпляр `Colormap` или зарегистрированное имя цветовой карты. cmap используется только если c является массивом чисел с плавающей точкой. `normNormalize, default: None` Если c является массивом чисел с плавающей точкой, norm используется для масштабирования данных цвета, c, в диапазоне от 0 до 1 для отображения на цветовой карте cmap. Если None, используется значение по умолчанию `colors.Normalize`. `vmin, vmaxfloat, default: None` vmin и vmax используются совместно с нормой по умолчанию для отображения массива цветов c на цветовой карте cmap. Если None, используются минимальное и максимальное значения массива цветов. Использование vmin/vmax при заданном norm устарело. `alphafloat, default: None` Значение прозрачности альфа-смешения, от 0 (прозрачный) до 1 (непрозрачный). `linewidthsfloat or array-like, default: rcParams["lines.linewidth"] (default: 1.5)` Ширина линии границ маркера. Примечание: по умолчанию edgecolors равно 'face'. Возможно, вы захотите это изменить. `edgecolors{'face', 'none', None} or color or sequence of color, default: rcParams["scatter.edgecolors"] (default: 'face')` Цвет границ маркера. Возможные значения: 'face': Цвет границ всегда будет совпадать с цветом заливки. 'none': Границы заливки не будут отрисованы. Цвет или последовательность цветов. Для маркеров без заливки ключевой аргумент edgecolors игнорируется и внутри устанавливается в 'face'. `plotnonfinitebool, default: False` Устанавливает для отображения точек с неопределёнными c, вместе с `set_bad`.
Возвращает:	`PathCollection`
Другие параметры:	`**kwargsCollection properties`

См. также

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

Примечания

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

Примечание

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