Spec-Zone.ru › Matplotlib 3.7

matplotlib.axes.Axes.spy

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

Построение матрицы разреженности 2D массива.

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

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

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

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

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

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

Параметры:
Z(M, N) array-like

Массив для построения.

precisionfloat или 'present', по умолчанию: 0

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

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

aspect{'equal', 'auto', None} или float, по умолчанию: '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

функция фильтра, которая принимает массив float (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.axes.Axes.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.axes.Axes.spy.html

Spec-Zone.ru

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