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) [source]

Диаграмма рассеяния y по x с различным размером и/или цветом маркеров.

Параметры:	x, y : array_like, shape (n, ) Позиции данных. s : scalar or array_like, shape (n, ), optional Размер маркера в пунктах**2. По умолчанию rcParams['lines.markersize'] ** 2. c : color, sequence, or sequence of color, optional, default: 'b' Цвет маркера. Возможные значения: Строка формата одного цвета. Последовательность спецификаций цветов длиной n. Последовательность n чисел, которые будут отображаться в цветах с использованием cmap и norm. 2-мерный массив, в котором строки — RGB или RGBA. Обратите внимание, что c не должен быть одиночной числовой последовательностью RGB или RGBA, потому что это неотличимо от массива значений, которые нужно отобразить в цветах. Если вы хотите указать одно и то же значение RGB или RGBA для всех точек, используйте 2-мерный массив с единственной строкой. marker : MarkerStyle, optional, default: 'o' Стиль маркера. marker может быть экземпляром класса или текстовым сокращением для определённого маркера. Дополнительную информацию о стилях маркеров см. в markers. cmap : Colormap, optional, default: None Экземпляр Colormap или зарегистрированное имя цветовой карты. cmap используется только если c — массив чисел с плавающей точкой. Если None, по умолчанию используется значение rc image.cmap. norm : Normalize, optional, default: None Экземпляр Normalize используется для масштабирования данных яркости до 0, 1. norm используется только если c — массив чисел с плавающей точкой. Если None, используется значение по умолчанию colors.Normalize. vmin, vmax : scalar, optional, default: None vmin и vmax используются совместно с norm для нормализации данных яркости. Если None, используются минимальное и максимальное значения массива цвета. vmin и vmax игнорируются, если вы передаёте экземпляр norm. alpha : scalar, optional, default: None Значение прозрачности, от 0 (прозрачный) до 1 (непрозрачный). linewidths : scalar or array_like, optional, default: None Толщина линии границ маркера. Обратите внимание: по умолчанию edgecolors — 'face'. Возможно, вам захочется это изменить. Если None, по умолчанию используется rcParams lines.linewidth. verts : sequence of (x, y), optional Если marker — None, эти вершины будут использоваться для построения маркера. Центр маркера расположен в (0, 0) в нормированных единицах. Маркер в целом масштабируется по s. edgecolors : color or sequence of color, optional, default: 'face' Цвет границ маркера. Возможные значения: 'face': Цвет границ всегда совпадает с цветом заливки. 'none': Граница маркера не рисуется. Цвет Matplotlib. Для маркеров без заливки аргумент edgecolors игнорируется и внутренне устанавливается в 'face'.
Возвращает:	paths : PathCollection
Другие параметры:	**kwargs : Collection properties

См. также

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

Диаграмма рассеяния

Диаграмма рассеяния на полярной оси

Гиперссылки

Демонстрация Z-порядка

Учебник по Pyplot