matplotlib.axes.Axes.scatter

Axes.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 или массив-подобный объект, форма (n, ) Позиции данных. sfloat или массив-подобный объект, форма (n, ), необязательно Размер маркера в пунктах2. По умолчанию `rcParams['lines.markersize'] 2`. cмассив-подобный объект или список цветов или цвет, необязательно Цвета маркеров. Возможные значения: Скаляр или последовательность 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'])`). 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, vmaxчисло с плавающей точкой, по умолчанию: None vmin и vmax используются совместно со значением по умолчанию norm, чтобы отобразить массив цветов c в цветовой карте cmap. Если None, используются минимальное и максимальное значения массива цветов. Использование vmin/vmax с заданным norm устарело. alphaчисло с плавающей точкой, по умолчанию: None Значение прозрачности, от 0 (прозрачный) до 1 (непрозрачный). linewidthsчисло с плавающей точкой или массив-подобный объект, по умолчанию: `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 могут быть введены как многомерные массивы, но внутри scatter они будут сглажены. Исключение составляет c, которое будет сглажено только в том случае, если его размер совпадает с размером x и y.

Примечание

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