matplotlib.cm

Mapas de color incorporados, utilidades de manejo de mapas de color y el ScalarMappablemixin.

Ver también

Referencia de mapa de colores para una lista de mapas de colores integrados.

Creación de mapas de colores en Matplotlib para ver ejemplos de cómo hacer mapas de colores.

Elegir mapas de colores en Matplotlib una discusión en profundidad sobre la elección de mapas de colores.

Normalización de mapa de colores para obtener más detalles sobre la normalización de datos.

clase matplotlib.cm. ColormapRegistry ( cmaps )

Bases:Mapping

Contenedor para mapas de colores que Matplotlib conoce por su nombre.

Experimental

Si bien esperamos que la API sea definitiva, la marcamos formalmente como experimental para 3.5 porque queremos mantener la opción de adaptar la API para 3.6 en caso de que surja la necesidad.

La instancia de registro universal es matplotlib.colormaps. No debería haber necesidad de que los usuarios creen una instancia de ColormapRegistrysí mismos.

El acceso de lectura utiliza una interfaz similar a un dictado que asigna nombres a Colormaps:

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

Los s devueltos Colormapson copias, por lo que su modificación no cambia la definición global del mapa de colores.

Se pueden agregar mapas de color adicionales a través de ColormapRegistry.register:

mpl.colormaps.register(my_colormap)

registrarse ( cmap , * , nombre = Ninguno , fuerza = Falso )

Registre un nuevo mapa de colores.

El nombre del mapa de colores se puede usar como argumento de cadena para cualquier cmap parámetro en Matplotlib. También está disponible en pyplot.get_cmap.

El registro del mapa de colores almacena una copia del mapa de colores dado, de modo que los cambios futuros en la instancia del mapa de colores original no afecten al mapa de colores registrado. Piense en esto como si el registro tomara una instantánea del mapa de colores en el momento del registro.

Parámetros :

cmap matplotlib.colores.Mapa de colores

El mapa de colores para registrar.

cadena de nombre , opcional

El nombre del mapa de colores. Si no se da, cmap.namese usa.

forzar bool, por defecto: Falso

Si es False, se genera un ValueError si se intenta sobrescribir un nombre ya registrado. True admite la sobrescritura de mapas de colores registrados que no sean los mapas de colores incorporados.

cancelar el registro ( nombre )

Eliminar un mapa de colores del registro.

No puede eliminar los mapas de colores integrados.

Si el mapa de colores nombrado no está registrado, regresa sin errores, se genera si intenta anular el registro de un mapa de colores predeterminado.

Advertencia

Los nombres de los mapas de colores son actualmente un espacio de nombres compartido que pueden utilizar varios paquetes. Úselo unregistersolo si sabe que ha registrado ese nombre anteriormente. En particular, no elimine el registro por si acaso para limpiar el nombre antes de registrar un nuevo mapa de colores.

Parámetros :

nombre str

El nombre del mapa de colores que se eliminará.

aumenta :

ValorError

Si intenta eliminar un mapa de colores incorporado predeterminado.

clase matplotlib.cm. ScalarMapable ( norma = Ninguno , cmap = Ninguno )

Bases:object

Una clase mixin para mapear datos escalares a RGBA.

ScalarMappable aplica la normalización de datos antes de devolver los colores RGBA del mapa de colores dado.

Parámetros :

norma Normalize(o subclase de la misma) o str o Ninguno

El objeto de normalización que escala los datos, normalmente en el intervalo . Si a , se genera dinámicamente una subclase basada en la escala con el nombre correspondiente. Si es Ninguno , el valor predeterminado es un objeto colors.Normalize que inicializa su escala en función de los primeros datos procesados.[0, 1]strNormalize

cmap str oColormap

El mapa de colores utilizado para asignar valores de datos normalizados a colores RGBA.

escala automática ( )

Escalar automáticamente los límites escalares en la instancia de la norma usando la matriz actual

autoscale_None ( )

Escale automáticamente los límites escalares en la instancia de norma utilizando la matriz actual, cambiando solo los límites que son Ninguno

propiedad callbacksSM

cambiado ( )

Llame a esto cada vez que se cambie el mapeable para notificar a todos los oyentes de callbackSM sobre la señal 'cambiada'.

barra de colores

La última barra de colores asociada con este ScalarMappable. Puede ser Ninguno.

get_alpha ( )

Devoluciones :

flotar

Siempre devuelve 1.

get_array ( )

Devuelve la matriz de valores, que se asignan a los colores.

La clase base ScalarMappableno hace ninguna suposición sobre la dimensionalidad y la forma de la matriz.

get_clim ( )

Devuelve los valores (mín., máx.) que se asignan a los límites del mapa de colores.

get_cmap ( )

Devolver la Colormapinstancia.

norma de propiedad

set_array ( A )

Establezca la matriz de valores de A similar a una matriz .

Parámetros :

Una matriz o Ninguna

Los valores que se asignan a los colores.

La clase base ScalarMappableno hace ninguna suposición sobre la dimensionalidad y la forma de la matriz de valores A .

set_clim ( vmin = Ninguno , vmax = Ninguno )

Establezca los límites de la norma para el escalado de imágenes.

Parámetros :

flotante vmin, vmax

Los limites.

Los límites también se pueden pasar como una tupla ( vmin , vmax ) como un solo argumento posicional.

set_cmap ( cmap )

Configure el mapa de colores para los datos de luminancia.

Parámetros :

cmap Colormapo str o Ninguno

set_norm ( norma )

Establezca la instancia de normalización.

Parámetros :

norma Normalizeo str o Ninguno

notas

Si hay barras de colores que utilizan el mapeable para esta norma, establecer la norma del mapeable restablecerá la norma, el localizador y los formateadores en la barra de colores a los valores predeterminados.

to_rgba ( x , alfa = Ninguno , bytes = Falso , norma = Verdadero )

Devuelve una matriz rgba normalizada correspondiente a x .

En el caso normal, x es una secuencia de escalares 1D o 2D, y se devolverá el correspondiente ndarray de valores rgba, según la norma y el mapa de colores establecidos para este ScalarMappable.

Existe un caso especial, para el manejo de imágenes que ya son rgb o rgba, como las que podrían haberse leído de un archivo de imagen. Si x es un ndarray con 3 dimensiones y la última dimensión es 3 o 4, se tratará como un arreglo rgb o rgba y no se realizará ninguna asignación. La matriz puede ser uint8, o puede ser un punto flotante con valores en el rango 0-1; de lo contrario, se generará un ValueError. Si es una matriz enmascarada, se ignorará la máscara. Si la última dimensión es 3, se utilizará el kwarg alfa (predeterminado en 1) para completar la transparencia. Si la última dimensión es 4, se ignora el kwarg alfa ; no reemplaza el alfa preexistente. Se generará un ValueError si la tercera dimensión es distinta de 3 o 4.

En cualquier caso, si bytes es False (predeterminado), la matriz rgba será flotante en el rango 0-1; si es True , la matriz rgba devuelta será uint8 en el rango de 0 a 255.

Si la norma es Falso, no se realiza la normalización de los datos de entrada y se supone que está en el rango (0-1).

matplotlib.cm. get_cmap ( nombre = Ninguno , lut = Ninguno )

[ Obsoleto ] Obtener una instancia de mapa de colores, por defecto a los valores rc si el nombre es Ninguno.

Parámetros :

nombre matplotlib.colors.Colormapo str o Ninguno, por defecto: Ninguno

Si es una Colormapinstancia, se devolverá. De lo contrario, el nombre de un mapa de colores conocido por Matplotlib, que lut volverá a muestrear . El valor predeterminado, Ninguno, significa rcParams["image.cmap"](predeterminado: 'viridis').

lut int o Ninguno, por defecto: Ninguno

Si name aún no es una instancia de Colormap y lut no es None, el mapa de colores se volverá a muestrear para tener entradas de lut en la tabla de búsqueda.

Devoluciones :

mapa de colores

notas

En desuso desde la versión 3.6: Usar matplotlib.colormaps[name]en su lugar.

matplotlib.cm. register_cmap ( nombre = Ninguno , cmap = Ninguno , * , override_builtin = False )

[En desuso ] Agregue un mapa de colores al conjunto reconocido por get_cmap().

Registre un nuevo mapa de colores para acceder por nombre

LinearSegmentedColormap('swirly', data, lut)
register_cmap(cmap=swirly_cmap)

Parámetros :

cadena de nombre , opcional

El nombre que se puede usar en get_cmap()o rcParams["image.cmap"](predeterminado: 'viridis')

Si está ausente, el nombre será el name atributo del cmap .

cmap matplotlib.colores.Mapa de colores

A pesar de ser el segundo argumento y tener un valor predeterminado, este es un argumento obligatorio.

override_builtin bool

Permita que los mapas de colores incorporados sean anulados por un mapa de colores proporcionado por el usuario.

Por favor, no utilice esto a menos que esté seguro de que lo necesita.

notas

En desuso desde la versión 3.6: Usar matplotlib.colormaps.register(name)en su lugar.

matplotlib.cm. unregister_cmap ( nombre )

[ Obsoleto ] Eliminar un mapa de colores reconocido por get_cmap().

No puede eliminar los mapas de colores integrados.

Si el mapa de colores nombrado no está registrado, regresa sin errores, se genera si intenta anular el registro de un mapa de colores predeterminado.

Advertencia

Los nombres de los mapas de colores son actualmente un espacio de nombres compartido que pueden utilizar varios paquetes. Úselo unregister_cmapsolo si sabe que ha registrado ese nombre anteriormente. En particular, no elimine el registro por si acaso para limpiar el nombre antes de registrar un nuevo mapa de colores.

Parámetros :

nombre str

El nombre del mapa de colores que se va a desregistrar

Devoluciones :

Mapa de colores o ninguno

Si el mapa de colores fue registrado, devuélvalo si no lo devuelveNone

aumenta :

ValorError

Si intenta anular el registro de un mapa de colores integrado predeterminado.

notas

En desuso desde la versión 3.6: Usar matplotlib.colormaps.unregister(name)en su lugar.