Spec-Zone.ru › Matplotlib 3.7

matplotlib.pyplot.spy

matplotlib.pyplot.spy(Z, precision=0, marker=None, markersize=None, aspect='equal', origin='upper', **kwargs)[source]

Отображение шаблона разреженности двумерного массива.

Это визуализирует ненулевые значения массива.

Доступны два стиля отображения: изображение и маркер. Оба доступны для полных массивов, но только стиль маркера работает для scipy.sparse.spmatrix экземпляров.

Стиль изображения

Если marker и markersize равны None, используется imshow. Любые дополнительные оставшиеся ключевые аргументы передаются этому методу.

Стиль маркера

Если Z — scipy.sparse.spmatrix или marker или markersize равны None, будет возвращён объект Line2D с типом маркера, определяемым значением marker, и любые оставшиеся ключевые аргументы передаются методу plot.

Параметры:
Z(M, N) массив

Массив, который будет отображен.

precisionчисло с плавающей точкой или 'present', по умолчанию: 0

Если precision равен 0, будут отображаться любые ненулевые значения. В противном случае, будут отображаться значения \(|Z| > precision\).

Для экземпляров scipy.sparse.spmatrix можно также передать 'present'. В этом случае будут отображаться любые присутствующие в массиве значения, даже если они идентичны нулю.

aspect{'equal', 'auto', None} или число, по умолчанию: 'equal'

Соотношение сторон оси. Этот параметр особенно важен для изображений, так как он определяет, являются ли данные пиксели квадратными.

Этот параметр является сокращением для явного вызова Axes.set_aspect. См. там подробности.

  • 'equal': Обеспечивает соотношение сторон 1. Пиксели будут квадратными.
  • 'auto': Ось сохраняется неизменной, а соотношение сторон подстраивается так, чтобы данные поместились на оси. В общем случае это приведет к неквадратным пикселям.
  • None: Используйте rcParams["image.aspect"] (по умолчанию: 'equal').
origin{'upper', 'lower'}, по умолчанию: rcParams["image.origin"] (по умолчанию: 'upper')

Расположить индекс [0, 0] массива в верхнем левом или нижнем левом углу оси. Конвенция 'upper' обычно используется для матриц и изображений.

Возвращаемое значение:
AxesImage или Line2D

Тип возвращаемого значения зависит от стиля отображения (см. выше).

Дополнительные параметры:
**kwargs

Поддерживаемые дополнительные параметры зависят от стиля отображения.

Для стиля изображения можно передать следующие дополнительные параметры imshow:

  • cmap
  • alpha
  • url
  • любые свойства Artist (передаются AxesImage)

Для стиля маркера можно передать любые свойства Line2D, кроме linestyle:

Свойство

Описание

agg_filter

функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения

alpha

скаляр или None

animated

bool

antialiased или aa

bool

clip_box

Bbox

clip_on

bool

clip_path

Объект Patch или (Path, Transform) или None

color или c

цвет

dash_capstyle

CapStyle или {'butt', 'projecting', 'round'}

dash_joinstyle

JoinStyle или {'miter', 'round', 'bevel'}

dashes

последовательность чисел с плавающей точкой (чернила/пробелы в пунктах) или (None, None)

data

массив (2, N) или два одномерных массива

drawstyle или ds

{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'

figure

Figure

fillstyle

{'full', 'left', 'right', 'bottom', 'top', 'none'}

gapcolor

цвет или None

gid

строка

in_layout

bool

label

объект

linestyle или ls

{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}

linewidth или lw

число с плавающей точкой

marker

строка стиля маркера, Path или MarkerStyle

markeredgecolor или mec

цвет

markeredgewidth или mew

число с плавающей точкой

markerfacecolor или mfc

цвет

markerfacecoloralt или mfcalt

цвет

markersize или ms

число с плавающей точкой

markevery

None или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список булевых значений

mouseover

bool

path_effects

AbstractPathEffect

picker

число с плавающей точкой или вызываемая функция [[Artist, Event], кортеж[bool, dict]]

pickradius

неизвестно

rasterized

bool

sketch_params

(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)

snap

bool или None

solid_capstyle

CapStyle или {'butt', 'projecting', 'round'}

solid_joinstyle

JoinStyle или {'miter', 'round', 'bevel'}

transform

неизвестно

url

строка

visible

bool

xdata

одномерный массив

ydata

Одномерный массив

zorder

вещественное число

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

Примеры использования функции spy

Примеры использования функции spy

© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.7.5/api/_as_gen/matplotlib.pyplot.spy.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API