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] массива в верхнем левом или нижнем левом углу оси. Конвенция 'верхний' обычно используется для матриц и изображений.

Возвращаемые значения:

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	BboxBase или None
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