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

Примечание

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