matplotlib.axes.Axes.pcolor

hachas pcolor ( * argumentos , sombreado = Ninguno , alfa = Ninguno , norma = Ninguno , cmap = Ninguno , vmin = Ninguno , vmax = Ninguno , data = Ninguno , ** kwargs )

Cree un diagrama de pseudocolor con una cuadrícula rectangular no regular.

Firma de llamada:

pcolor([X, Y,] C, **kwargs)

X e Y se pueden usar para especificar las esquinas de los cuadriláteros.

Insinuación

pcolor()puede ser muy lento para arreglos grandes. En la mayoría de los casos, debe usar el similar pero mucho más rápido pcolormesh. Ver Diferencias entre pcolor() y pcolormesh() para una discusión de las diferencias.

Parámetros :

C 2D tipo matriz

Los valores mapeados en color. El mapeo de colores está controlado por cmap , norm , vmin y vmax .

X, Y tipo matriz, opcional

Las coordenadas de las esquinas de los cuadriláteros de una pcolormesh:

(X[i+1, j], Y[i+1, j])       (X[i+1, j+1], Y[i+1, j+1])
                      +-----+
                      |     |
                      +-----+
    (X[i, j], Y[i, j])       (X[i, j+1], Y[i, j+1])

Tenga en cuenta que el índice de la columna corresponde a la coordenada x y el índice de la fila corresponde a y. Para obtener más información, consulte la sección Notas a continuación.

Si shading='flat'las dimensiones de X e Y deben ser uno más grandes que las de C , y el cuadrilátero está coloreado debido al valor en . Si X , Y y C tienen las mismas dimensiones, se generará una advertencia y se ignorarán la última fila y la última columna de C.C[i, j]

Si shading='nearest', las dimensiones de X e Y deberían ser las mismas que las de C (si no, se generará un ValueError). El color se centrará en .C[i, j](X[i, j], Y[i, j])

Si X y/o Y son matrices 1-D o vectores de columna, se expandirán según sea necesario en las matrices 2D apropiadas, formando una cuadrícula rectangular.

sombreado {'plano', 'más cercano', 'automático'}, predeterminado: rcParams["pcolor.shading"](predeterminado 'auto':)

El estilo de relleno para el cuadrilátero. Valores posibles:

• 'plano': se utiliza un color sólido para cada quad. El color del cuadrilátero (i, j), (i+1, j), (i, j+1), (i+1, j+1) viene dado por . Las dimensiones de X e Y deben ser uno mayor que las de C ; si son iguales a C , se genera una advertencia de desaprobación y se eliminan la última fila y columna de C .C[i, j]

• 'más cercano': Cada punto de la cuadrícula tendrá un color centrado en él, extendiéndose a mitad de camino entre los centros de la cuadrícula adyacentes. Las dimensiones de X e Y deben ser las mismas que las de C.

• 'auto': elija 'plano' si las dimensiones de X e Y son más grandes que C . Elija 'más cercano' si las dimensiones son las mismas.

Ver cuadrículas de pcolormesh y sombreado para más descripción.

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.

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 .

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

edgecolors {'ninguno', Ninguno, 'cara', color, secuencia de colores}, opcional

El color de los bordes. El valor predeterminado es 'ninguno'. Valores posibles:

• 'ninguno' o '': Sin borde.

• Ninguno : rcParams["patch.edgecolor"](predeterminado: 'black') se utilizará. Tenga en cuenta que actualmente rcParams["patch.force_edgecolor"](predeterminado: False) tiene que ser Verdadero para que esto funcione.

• 'cara': usa el color de la cara adyacente.

• Un color o secuencia de colores establecerá el color del borde.

La forma singular edgecolor funciona como un alias.

flotante alfa , predeterminado: Ninguno

El valor de fusión alfa del color de la cara, entre 0 (transparente) y 1 (opaco). Nota: El color del borde actualmente no se ve afectado por esto.

snap bool, predeterminado: falso

Ya sea para ajustar la malla a los límites de píxeles.

Devoluciones :

matplotlib.collections.Collection

Otros parámetros :

antialiased bool, predeterminado: Falso

El antialiased predeterminado es False si se usa edgecolors = "none" predeterminado. Esto elimina las líneas artificiales en los límites del parche y funciona independientemente del valor de alfa. Si edgecolors no es "ninguno", el antialiasing predeterminado se toma de rcParams["patch.antialiased"](predeterminado: True). Se puede preferir acariciar los bordes si alfa es 1, pero de lo contrario causará artefactos.

objeto indexable de datos , opcional

Si se proporciona, todos los parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción).

**kwargs

Además, se permiten los siguientes argumentos. Se pasan al PolyCollectionconstructor:

Propiedad	Descripción
agg_filter	una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
alpha	tipo matriz o escalar o ninguno
animated	bool
antialiasedo aa o suavizado	bool o lista de bools
array	tipo matriz o ninguno
capstyle	CapStyleo {'trasero', 'proyectando', 'redondo'}
clim	(vmin: flotante, vmax: flotante)
clip_box	Bbox
clip_on	bool
clip_path	Parchear o (Ruta, Transformar) o Ninguno
cmap	Colormapo str o Ninguno
color	color o lista de tuplas rgba
edgecoloro ec o edgecolors	color o lista de colores o 'cara'
facecoloro colores de cara o fc	color o lista de colores
figure	Figure
gid	calle
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleo {'inglete', 'redondo', 'bisel'}
label	objeto
linestyleo guiones o estilos de línea o ls	str o tuple o lista de los mismos
linewidtho anchos de línea o lw	flotador o lista de flotadores
mouseover	bool
norm	Normalizeo str o Ninguno
offset_transformo transOffset	desconocido
offsets	(N, 2) o (2,) en forma de matriz
path_effects	AbstractPathEffect
paths	lista de tipo matriz
picker	Ninguno o bool o flotante o invocable
pickradius	desconocido
rasterized	bool
sizes	ndarray o Ninguno
sketch_params	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
snap	booleano o ninguno
transform	Transform
url	calle
urls	lista de str o Ninguno
verts	lista de tipo matriz
verts_and_codes	desconocido
visible	bool
zorder	flotar

Ver también

pcolormesh

para obtener una explicación de las diferencias entre pcolor y pcolormesh.

imshow

Si X e Y son equidistantes, imshowpuede ser una alternativa más rápida.

notas

Matrices enmascaradas

X , Y y C pueden ser matrices enmascaradas. Si cualquiera de los , o uno de los vértices circundantes ( X o Y en ) está enmascarado, no se traza nada.C[i, j]C[i, j][i, j], [i+1, j], [i, j+1], [i+1, j+1]

Orientación de cuadrícula

La orientación de la cuadrícula sigue la convención de matriz estándar: una matriz C con forma (nrows, ncolumns) se traza con el número de columna como X y el número de fila como Y .

Ejemplos usando matplotlib.axes.Axes.pcolor

Demostración de color

Demostración de color

Controlar los límites de vista usando márgenes y sticky_edges

Controlar los límites de vista usando márgenes y sticky_edges