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) array-like

Массив, подлежащий построению.

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

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

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

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

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

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

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

origin{'upper', 'lower'}, по умолчанию: rcParams["image.origin"] (по умолчанию: 'upper')

Разместите индекс [0, 0] массива в верхнем левом или нижнем левом углу области Axes. Конвенция '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`	вещественное число