matplotlib.axes.Axes.scatter

Axes.scatter(self, 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 лежат одномерные массивы; x, y, s и c могут быть введены как многомерные массивы, но в scatter они будут сглажены. Исключение составляет c, который будет сглажен только в том случае, если его размер соответствует размеру x и y.

Примечание

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