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, verts=None, edgecolors=None, *, data=None, **kwargs)

Построение диаграммы рассеяния x по y.

Размер маркера масштабируется s, а цвет маркера отображается в соответствии с c.

Параметры:	x, y : массив_подобный, форма (n, ) Входные данные s : скаляр или массив_подобный, форма (n, ), необязательно размер в точках^2. По умолчанию rcParams['lines.markersize'] ** 2. c : цвет, последовательность или последовательность цветов, необязательно, по умолчанию: ‘b’ c может быть строкой формата одного цвета, или последовательностью спецификаций цвета длиной N, или последовательностью N чисел, которые будут отображаться в цветах с использованием cmap и norm, указанных через kwargs (см. ниже). Обратите внимание, что c не должна быть одиночной числовой последовательностью RGB или RGBA, потому что это неотличимо от массива значений, подлежащих отображению в цвета. c может быть двумерным массивом, в котором строки представляют RGB или RGBA, в том числе в случае одной строки для указания одного и того же цвета для всех точек. marker : MarkerStyle, необязательно, по умолчанию: ‘o’ См. markers для получения дополнительной информации о различных стилях маркеров, которые поддерживает scatter. marker может быть либо экземпляром класса, либо текстовым сокращением для определенного маркера. cmap : Colormap, необязательно, по умолчанию: None Экземпляр Colormap или зарегистрированное имя. cmap используется только в том случае, если c является массивом чисел с плавающей запятой. Если None, по умолчанию используется rc image.cmap. norm : Normalize, необязательно, по умолчанию: None Экземпляр Normalize используется для масштабирования данных яркости до 0, 1. norm используется только в том случае, если c является массивом чисел с плавающей запятой. Если None, используется значение по умолчанию normalize(). vmin, vmax : скаляр, необязательно, по умолчанию: None vmin и vmax используются совместно с norm для нормализации данных яркости. Если один из них None, используется минимум и максимум массива цветов. Обратите внимание, что если вы передаете экземпляр norm, ваши настройки для vmin и vmax будут проигнорированы. alpha : скаляр, необязательно, по умолчанию: None Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный) linewidths : скаляр или массив_подобный, необязательно, по умолчанию: None Если None, по умолчанию используется (lines.linewidth,). verts : последовательность (x, y), необязательно Если marker равно None, эти вершины будут использоваться для построения маркера. Центр маркера расположен в (0,0) в нормализованных единицах. Весь маркер масштабируется на s. edgecolors : цвет или последовательность цветов, необязательно, по умолчанию: None Если None, по умолчанию используется ‘face’ Если ‘face’, цвет границы всегда совпадает с цветом заливки. Если ‘none’, граница области не будет отображаться. Для маркеров без заливки аргумент edgecolors игнорируется и принудительно устанавливается в ‘face’ внутри.
Возвращает:	paths : PathCollection
Другие параметры:
	**kwargs : Collection свойства

См. также

plot

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

Примечания

• Функция plot будет быстрее для диаграмм рассеяния, где маркеры не меняются по размеру или цвету.

• Любые или все из x, y, s, и c могут быть массивами с пропусками, в этом случае все маски будут объединены, и будут нарисованы только точки без пропусков.

  В основе scatter лежат 1-мерные массивы; x, y, s, и c могут быть введены как 2-мерные массивы, но внутри scatter они будут сглажены. Исключение составляет c, который будет сглажен только в том случае, если его размер соответствует размеру x и y.

Примечание

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

• Все аргументы с следующими именами: ‘c’, ‘color’, ‘edgecolors’, ‘facecolor’, ‘facecolors’, ‘linewidths’, ‘s’, ‘x’, ‘y’.