matplotlib.pyplot.figimage

matplotlib.pyplot. figimage ( X , xo = 0 , yo = 0 , alpha = Ninguno , norm = Ninguno , cmap = Ninguno , vmin = Ninguno , vmax = Ninguno , origen = Ninguno , redimensionar = Falso , ** kwargs )

Agregue una imagen no remuestreada a la figura.

La imagen se adjunta en la esquina inferior o superior izquierda según el origen .

Parámetros :

X

Los datos de la imagen. Esta es una matriz de una de las siguientes formas:

• (M, N): una imagen con datos escalares. El mapeo de colores está controlado por cmap , norm , vmin y vmax .

• (M, N, 3): una imagen con valores RGB (0-1 flotante o 0-255 int).

• (M, N, 4): una imagen con valores RGBA (0-1 flotante o 0-255 int), es decir, que incluye transparencia.

xo, yo ent

El desplazamiento de la imagen x / y en píxeles.

alfa Ninguno o flotante

El valor de mezcla alfa.

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

La instancia de mapa de colores o el nombre de mapa de colores registrado que se utiliza para asignar datos escalares a colores.

Este parámetro se ignora si X es RGB(A).

norma str o Normalize, opcional

El método de normalización usado para escalar datos escalares al rango [0, 1] antes de mapear a colores usando cmap . De forma predeterminada, se utiliza una escala lineal, asignando el valor más bajo a 0 y el más alto a 1.

Si se da, puede ser uno de los siguientes:

• Una instancia de Normalizeo una de sus subclases (consulte Normalización de mapa de colores ).

• Un nombre de escala, es decir, uno de "linear", "log", "symlog", "logit", etc. Para obtener una lista de las escalas disponibles, llame al matplotlib.scale.get_scale_names(). NormalizeEn ese caso, se genera e instancia dinámicamente una subclase adecuada .

Este parámetro se ignora si X es RGB(A).

vmin, vmax flotante, opcional

Cuando se usan datos escalares y no hay una norma explícita , vmin y vmax definen el rango de datos que cubre el mapa de colores. De forma predeterminada, el mapa de colores cubre el rango de valores completo de los datos proporcionados. Es un error usar vmin / vmax cuando se proporciona una instancia de norma (pero es aceptable usar un nombre de norma junto con vmin / vmax ).str

Este parámetro se ignora si X es RGB(A).

origen {'superior', 'inferior'}, predeterminado: rcParams["image.origin"](predeterminado 'upper':)

Indica dónde está el índice [0, 0] de la matriz en la esquina superior izquierda o inferior izquierda de los ejes.

cambiar el tamaño de bool

Si es Verdadero , cambie el tamaño de la figura para que coincida con el tamaño de imagen dado.

Devoluciones :

matplotlib.image.FigureImage

Otros parámetros :

**kwargs

Los kwargs adicionales son Artistkwargs pasados ​​a FigureImage.

notas

figimage complementa la imagen de Axes ( imshow) que se volverá a muestrear para ajustarse a los Axes actuales. Si desea que una imagen remuestreada ocupe toda la figura, puede definir una Axescon extensión [0, 0, 1, 1].

Ejemplos

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()