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, yscalar or array-like, shape (n, )` Позиции данных. `sscalar 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, optional` Стиль маркера. marker может быть экземпляром класса или текстовым сокращением для конкретного маркера. По умолчанию `None`, в этом случае он принимает значение `rcParams["scatter.marker"]` (по умолчанию: 'o') = 'o'. См. `markers` для получения дополнительной информации о стилях маркеров. `cmapColormap, optional, default: None` Экземпляр `Colormap` или зарегистрированное имя цветовой карты. cmap используется только если c — массив чисел с плавающей точкой. Если `None`, по умолчанию rc `image.cmap`. `normNormalize, optional, default: None` Экземпляр `Normalize` используется для масштабирования данных яркости до 0, 1. norm используется только если c — массив чисел с плавающей точкой. Если None, используется по умолчанию `colors.Normalize`. `vmin, vmaxscalar, optional, default: None` vmin и vmax используются совместно с norm для нормализации данных яркости. Если None, используются минимальное и максимальное значения массива цветов. vmin и vmax игнорируются, если вы передаете экземпляр norm. `alphascalar, optional, default: None` Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). `linewidthsscalar or array-like, optional, default: None` Толщина линии краев маркера. Обратите внимание: по умолчанию edgecolors — 'face'. Возможно, вам потребуется изменить это. Если None, по умолчанию `rcParams["lines.linewidth"]` (по умолчанию: 1.5). `edgecolors{'face', 'none', None} or color or sequence of color, optional.` Цвет краев маркера. Возможные значения: 'face': Цвет краев всегда будет совпадать с цветом заливки. 'none': Граница области не будет нарисована. Цвет Matplotlib или последовательность цветов. По умолчанию `None`, в этом случае он принимает значение `rcParams["scatter.edgecolors"]` (по умолчанию: 'face') = 'face'. Для маркеров без заливки ключевое слово edgecolors игнорируется и внутри принудительно устанавливается в 'face'. `plotnonfiniteboolean, optional, default: False` Устанавливает точки с бесконечными значениями c совместно с `set_bad`.
Возвращает:	`pathsPathCollection`
Другие параметры:	`**kwargsCollection properties`

См. также

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

Примечания

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

Примечание

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