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, *, 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'])).

markerMarkerStyle, по умолчанию rcParams["scatter.marker"] (по умолчанию 'o')

Стиль маркера. marker может быть экземпляром класса или текстовым сокращением для определённого маркера. Смотрите matplotlib.markers для получения дополнительной информации о стилях маркеров.

cmapстрока или Colormap, по умолчанию rcParams["image.cmap"] (по умолчанию 'viridis')

Экземпляр Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.

Этот параметр игнорируется, если c является RGB(A).

normстрока или Normalize, необязательно

Метод нормализации, используемый для масштабирования скалярных данных в диапазон [0, 1] перед сопоставлением с цветами с помощью cmap. По умолчанию используется линейное масштабирование, сопоставляющее наименьшее значение с 0, а наибольшее - с 1.

Если задано, это может быть одним из следующих:

• Экземпляр Normalize или один из его подклассов (см. Нормализация цветовых карт).
• Имя масштаба, например, "linear", "log", "symlog", "logit" и т.д. Для получения списка доступных масштабов вызовите matplotlib.scale.get_scale_names(). В этом случае динамически создается и инициализируется соответствующий подкласс Normalize.

Этот параметр игнорируется, если c является RGB(A).

vmin, vmaxfloat, необязательно

При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который покрывает цветовая карта. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. Использование vmin/vmax при заданном экземпляре norm - ошибка (но использование строки norm вместе с vmin/vmax приемлемо).

Этот параметр игнорируется, если c является RGB(A).

alphafloat, по умолчанию: None

Значение смешивания альфа-канала, между 0 (прозрачный) и 1 (непрозрачный).

linewidthsfloat или массив-подобный объект, по умолчанию: 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

Другие параметры:

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение):

x, y, s, linewidths, edgecolors, c, facecolor, facecolors, color

**kwargsCollection свойства

См. также

plot

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

Примечания

• Функция plot будет быстрее для диаграмм рассеяния, где маркеры не изменяются по размеру или цвету.
• Любой или все из x, y, s и c могут быть масками, в этом случае все маски будут объединены, и будут нарисованы только точки без маски.
• В основе scatter лежат одномерные массивы; x, y, s и c могут быть введены как N-мерные массивы, но внутри scatter они будут выровнены. Исключением является c, который будет выровнен только в том случае, если его размер соответствует размеру x и y.

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

Маскированный точечный график

Маскированный точечный график

Точечный график

Точечный график

Гиперссылки

Гиперссылки

Учебник по Pyplot

Учебник по Pyplot