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 с типом маркера, определяемым значением 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	функция фильтра, которая принимает массив 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'}
gid	строка
in_layout	bool
label	объект
linestyle или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включений/выключений), ...}
linewidth или lw	вещественное число
marker	строка стиля маркера, Path или MarkerStyle
markeredgecolor или mec	цвет
markeredgewidth или mew	вещественное число
markerfacecolor или mfc	цвет
markerfacecoloralt или mfcalt	цвет
markersize или ms	вещественное число
markevery	None или целое число или (целое число, целое число) или срез или список целых чисел или вещественное число или (вещественное число, вещественное число) или список булевых значений
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