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

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

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

Параметры:	x, y : array_like, форма (n, ) Входные данные s : скаляр или array_like, форма (n, ), необязательно размер в точках^2. По умолчанию rcParams['lines.markersize'] ** 2. c : цвет, последовательность или последовательность цветов, необязательно, по умолчанию: ‘b’ c может быть строкой формата одного цвета, или последовательностью спецификаций цветов длиной N, или последовательностью N чисел, которые будут отображаться в цветах с помощью cmap и norm, указанных через kwargs (см. ниже). Обратите внимание, что c не должен быть одиночной числовой RGB или RGBA последовательностью, поскольку это неотличимо от массива значений, подлежащих отображению в цветах. c может быть 2-мерным массивом, в котором строки являются 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 : скаляр или array_like, необязательно, по умолчанию: 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’.

Примеры использования matplotlib.pyplot.scatter

Scatter Symbol

Scatter Masked

Scatter Star Poly

Griddata Demo

Demonstration of advanced quiver and quiverkey functions

Scatter plot

Hyperlinks

Zorder Demo

Pyplot tutorial