Spec-Zone.ru › Matplotlib 3.6

matplotlib.axes.Axes.spy

Axes.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 с типом маркера, определяемым значением маркера, а любые оставшиеся ключевые аргументы передаются в plot.

Parameters:
Z(M, N) array-like

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

precisionfloat or 'present', default: 0

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

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

aspect{'equal', 'auto', None} or float, default: 'equal'

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

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

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

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

Returns:
AxesImage или Line2D

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

Other Parameters:
**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 Demos

Примеры отображения разреженности

Примеры отображения разреженности

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

Spec-Zone.ru

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