matplotlib.axes.Axes.pcolor #
- hachas pcolor ( * argumentos , sombreado = Ninguno , alfa = Ninguno , norma = Ninguno , cmap = Ninguno , vmin = Ninguno , vmax = Ninguno , data = Ninguno , ** kwargs ) [fuente] #
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ápidopcolormesh
. 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
Normalize
o 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()
.Normalize
En 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 actualmentercParams["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 :
- 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 comodata[s]
(a menos que esto genere una excepción).- **kwargs
Además, se permiten los siguientes argumentos. Se pasan al
PolyCollection
constructor:Propiedad
Descripción
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
tipo matriz o escalar o ninguno
bool
antialiased
o aa o suavizadobool o lista de bools
tipo matriz o ninguno
CapStyle
o {'trasero', 'proyectando', 'redondo'}(vmin: flotante, vmax: flotante)
bool
Parchear o (Ruta, Transformar) o Ninguno
Colormap
o str o Ningunocolor o lista de tuplas rgba
edgecolor
o ec o edgecolorscolor o lista de colores o 'cara'
facecolor
o colores de cara o fccolor o lista de colores
calle
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
bool
JoinStyle
o {'inglete', 'redondo', 'bisel'}objeto
linestyle
o guiones o estilos de línea o lsstr o tuple o lista de los mismos
linewidth
o anchos de línea o lwflotador o lista de flotadores
bool
Normalize
o str o Ningunooffset_transform
o transOffsetdesconocido
(N, 2) o (2,) en forma de matriz
lista de tipo matriz
Ninguno o bool o flotante o invocable
desconocido
bool
sizes
ndarray o Ninguno
(escala: flotante, longitud: flotante, aleatoriedad: flotante)
booleano o ninguno
calle
lista de str o Ninguno
lista de tipo matriz
desconocido
bool
flotar
Ver también
pcolormesh
para obtener una explicación de las diferencias entre pcolor y pcolormesh.
imshow
Si X e Y son equidistantes,
imshow
puede 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
#
![Controlar los límites de vista usando márgenes y sticky_edges](/stable/_images/sphx_glr_axes_margins_thumb.png)
Controlar los límites de vista usando márgenes y sticky_edges