matplotlib.pyplot.figimage

matplotlib.pyplot. figimage ( X , xo = 0 , yo = 0 , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , origin = None , resize = False , ** kwargs )

Adicione uma imagem sem reamostragem à figura.

A imagem é anexada ao canto inferior ou superior esquerdo, dependendo da origem .

Parâmetros :

x

Os dados da imagem. Esta é uma matriz de uma das seguintes formas:

• (M, N): uma imagem com dados escalares. O mapeamento de cores é controlado por cmap , norm , vmin e vmax .

• (M, N, 3): uma imagem com valores RGB (0-1 float ou 0-255 int).

• (M, N, 4): uma imagem com valores RGBA (0-1 float ou 0-255 int), ou seja, incluindo transparência.

xo, yo int

O deslocamento da imagem x / y em pixels.

alfa Nenhum ou flutuante

O valor de mistura alfa.

cmap str ou Colormap, padrão: rcParams["image.cmap"](padrão: 'viridis')

A instância do Colormap ou nome do mapa de cores registrado usado para mapear dados escalares para cores.

Este parâmetro é ignorado se X for RGB(A).

norma str ou Normalize, opcional

O método de normalização usado para dimensionar dados escalares para o intervalo [0, 1] antes de mapear para cores usando cmap . Por padrão, uma escala linear é usada, mapeando o valor mais baixo para 0 e o mais alto para 1.

Se fornecido, pode ser um dos seguintes:

• Uma instância Normalizeou uma de suas subclasses (consulte Normalização do mapa de cores ).

• Um nome de escala, ou seja, um de "linear", "log", "symlog", "logit", etc. Para obter uma lista de escalas disponíveis, chame matplotlib.scale.get_scale_names(). Nesse caso, uma Normalizesubclasse adequada é gerada e instanciada dinamicamente.

Este parâmetro é ignorado se X for RGB(A).

vmin, vmax flutuante, opcional

Ao usar dados escalares e nenhuma norma explícita , vmin e vmax definem o intervalo de dados que o mapa de cores cobre. Por padrão, o mapa de cores cobre toda a faixa de valores dos dados fornecidos. É um erro usar vmin / vmax quando uma instância de norma é fornecida (mas usar um nome de norma junto com vmin / vmax é aceitável).str

Este parâmetro é ignorado se X for RGB(A).

origem {'superior', 'inferior'}, padrão: rcParams["image.origin"](padrão: 'upper')

Indica onde o índice [0, 0] da matriz está no canto superior esquerdo ou inferior esquerdo dos eixos.

redimensionar bool

Se True , redimensione a figura para corresponder ao tamanho da imagem fornecido.

Devoluções :

matplotlib.image.FigureImage

Outros Parâmetros :

** kwargs

Kwargs adicionais são Artistkwargs transmitidos para FigureImage.

Notas

figimage complementa a imagem dos Axes ( imshow) que será reamostrada para caber nos Axes atuais. Se você quiser uma imagem reamostrada para preencher toda a figura, você pode definir um Axescom extensão [0, 0, 1, 1].

Exemplos

f = plt.figure()
nx = int(f.get_figwidth() * f.dpi)
ny = int(f.get_figheight() * f.dpi)
data = np.random.random((ny, nx))
f.figimage(data)
plt.show()