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} или 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`	функция фильтра, которая принимает (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 или int или (int, int) или срез или список[int] или вещественное число или (вещественное число, вещественное число) или список[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`	вещественное число