Spec-Zone.ru › Matplotlib 3.1

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 : array-like (M, N)

Массив, который нужно построить.

precision : float or 'present', optional, default: 0

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

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

origin : {'upper', 'lower'}, optional

Размещает индекс [0,0] массива в верхнем левом или нижнем левом углу осей. Обычно используется конвенция 'верхний' для матриц и изображений. Если не указано, используется rcParams["image.origin"], по умолчанию 'верхний'.

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

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

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

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

По умолчанию: 'equal'

Возвращаемое значение:
ret : AxesImage or Line2D

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

Другие параметры:
**kwargs

Поддерживаемые дополнительные параметры зависят от стиля построения графика.

Для стиля изображения вы можете передать следующие дополнительные параметры imshow:

  • cmap
  • alpha
  • url
  • любые свойства Artist (передаваемые в AxesImage)

Для стиля маркера вы можете передать любые свойства Line2D, кроме linestyle:

Свойство Описание
agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha вещественное число
animated логическое значение
antialiased или aa логическое значение
clip_box Bbox
clip_on логическое значение
clip_path [(Path, Transform) | Patch | None]
color или c цвет
contains вызываемый объект
dash_capstyle {'butt', 'round', 'projecting'}
dash_joinstyle {'miter', 'round', 'bevel'}
dashes последовательность чисел с плавающей точкой (включённая/отключённая чернила в точках) или (None, None)
drawstyle или ds {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
figure Figure
fillstyle {'full', 'left', 'right', 'bottom', 'top', 'none'}
gid строка
in_layout логическое значение
label объект
linestyle или ls {'-', '--', '-.', ':', '', (смещение, последовательность включ/выкл), ...}
linewidth или lw вещественное число
marker стиль маркера
markeredgecolor или mec цвет
markeredgewidth или mew вещественное число
markerfacecolor или mfc цвет
markerfacecoloralt или mfcalt цвет
markersize или ms вещественное число
markevery None или целое число или (целое число, целое число) или срез или список целых чисел или вещественное число или (вещественное число, вещественное число)
path_effects AbstractPathEffect
picker вещественное число или вызываемый объект [[Artist, Event], Tuple[bool, dict]]
pickradius вещественное число
rasterized логическое значение или None
sketch_params (масштаб: вещественное число, длина: вещественное число, случайность: вещественное число)
snap логическое значение или None
solid_capstyle {'butt', 'round', 'projecting'}
solid_joinstyle {'miter', 'round', 'bevel'}
transform matplotlib.transforms.Transform
url строка
visible логическое значение
xdata одномерный массив
ydata одномерный массив
zorder вещественное число

Примеры использования matplotlib.pyplot.spy

../../_images/sphx_glr_spy_demos_thumb.png

Примеры использования Spy

© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.1.1/api/_as_gen/matplotlib.pyplot.spy.html

Spec-Zone.ru

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