matplotlib.pyplot.colorbar #
- matplotlib.pyplot. colorbar ( asignable = Ninguno , cax = Ninguno , ax = Ninguno , ** kwargs ) [fuente] #
Añadir una barra de colores a un gráfico.
- Parámetros :
- mapeable
El
matplotlib.cm.ScalarMappable(es decir,AxesImage,ContourSet, etc.) descrito por esta barra de colores. Este argumento es obligatorio para elFigure.colorbarmétodo pero opcional para lapyplot.colorbarfunción, que establece el valor predeterminado de la imagen actual.Tenga en cuenta que se puede crear un
ScalarMappable"sobre la marcha" para generar barras de color no adjuntas a un artista dibujado previamente, por ejemplofig.colorbar(cm.ScalarMappable(norm=norm, cmap=cmap), ax=ax)
- cax
Axes, opcional Ejes en los que se dibujará la barra de colores.
- hacha
Axes, lista de ejes, opcional Uno o más ejes principales de los que se robará espacio para nuevos ejes de barra de color, si cax es Ninguno. Esto no tiene efecto si se establece cax .
- use_gridspec booleano , opcional
Si cax es
None, se crea un nuevo cax como instancia de Axes. Si ax es una instancia de Subplot y use_gridspec esTrue, cax se crea como una instancia de Subplot usando elgridspecmódulo.
- Devoluciones :
- barra de color
Colorbar
- barra de color
- Otros parámetros :
- ubicación Ninguno o {'izquierda', 'derecha', 'superior', 'inferior'}
La ubicación, relativa a los ejes principales, donde se crean los ejes de la barra de colores. También determina la orientación de la barra de colores (las barras de colores de la izquierda y la derecha son verticales, las barras de colores de la parte superior e inferior son horizontales). Si es Ninguno, la ubicación provendrá de la orientación si está configurada (barras de colores verticales a la derecha, horizontales en la parte inferior), o por defecto a 'derecha' si la orientación no está configurada.
- orientación Ninguna o {'vertical', 'horizontal'}
La orientación de la barra de colores. Es preferible establecer la ubicación de la barra de colores, ya que eso también determina la orientación ; pasar valores incompatibles para la ubicación y la orientación genera una excepción.
- fracción flotante, por defecto: 0.15
Fracción de ejes originales que se usarán para la barra de colores.
- retráctil flotante, por defecto: 1.0
Fracción por la que se multiplica el tamaño de la barra de colores.
- flotante de aspecto , predeterminado: 20
Relación de dimensiones largas a cortas.
- pad float, predeterminado: 0,05 si es vertical, 0,15 si es horizontal
Fracción de ejes originales entre la barra de colores y los ejes de la nueva imagen.
- ancla (flotador, flotador), opcional
El punto de anclaje de los ejes de la barra de colores. El valor predeterminado es (0,0, 0,5) si es vertical; (0.5, 1.0) si es horizontal.
- panchor (float, float), o False , opcional
El punto de anclaje de los ejes principales de la barra de colores. Si es False , el ancla de los ejes principales no cambiará. El valor predeterminado es (1,0, 0,5) si es vertical; (0.5, 0.0) si es horizontal.
- extender {'ninguno', 'ambos', 'min', 'max'}
Haga extremos puntiagudos para valores fuera de rango (a menos que sea 'ninguno'). Estos se configuran para un mapa de colores dado usando los métodos de mapa de colores set_under y set_over.
- extendfrac { Ninguno , 'auto', longitud, longitudes}
Si se establece en Ninguno , las extensiones de la barra de colores triangulares mínima y máxima tendrán una longitud del 5 % de la longitud de la barra de colores interior (esta es la configuración predeterminada).
Si se establece en 'auto', hace que las extensiones de la barra de colores triangulares tengan la misma longitud que los cuadros interiores (cuando el espaciado se establece en 'uniforme') o la misma longitud que los respectivos cuadros interiores adyacentes (cuando el espaciado se establece en 'proporcional').
Si es un escalar, indica la longitud de las extensiones de barra de colores triangulares mínima y máxima como una fracción de la longitud de la barra de colores interior. También se puede dar una secuencia de fracciones de dos elementos, indicando las longitudes de las extensiones mínima y máxima de la barra de colores, respectivamente, como una fracción de la longitud de la barra de colores interior.
- extender el bool
Si es False , las extensiones mínima y máxima de la barra de colores serán triangulares (el valor predeterminado). Si es Verdadero , las extensiones serán rectangulares.
- espaciado {'uniforme', 'proporcional'}
Para barras de colores discretas (
BoundaryNormo contornos), 'uniforme' le da a cada color el mismo espacio; 'proporcional' hace que el espacio sea proporcional al intervalo de datos.- ticks Ninguno o lista de ticks o localizador
Si es Ninguno, los ticks se determinan automáticamente a partir de la entrada.
- formato Ninguno o str o Formateador
Si Ninguno,
ScalarFormatterse utiliza. Se admiten cadenas de formato, por ejemplo,"%4.2e"o"{x:.2e}".FormatterEn su lugar, se puede dar una alternativa .- Bordes dibujados bool
Ya sea para dibujar líneas en los límites de color.
- cadena de etiquetas
La etiqueta en el eje largo de la barra de colores.
- límites, valores Ninguno o una secuencia
Si no está configurado, el mapa de colores se mostrará en una escala de 0-1. Si son secuencias, los valores deben tener una longitud 1 menor que los límites . Para cada región delimitada por entradas adyacentes en los límites , se utilizará el color asignado al valor correspondiente en valores. Normalmente solo es útil para colores indexados (es decir,
norm=NoNorm()) u otras circunstancias inusuales.
notas
Si mapeable es un
ContourSet, su extensión kwarg se incluye automáticamente.Shrink kwarg proporciona una forma sencilla de escalar la barra de colores con respecto a los ejes. Tenga en cuenta que si se especifica cax , determina el tamaño de la barra de colores y se ignoran los kwargs de aspecto y reducción.
Para un control más preciso, puede especificar manualmente las posiciones de los objetos de los ejes en los que se dibujan el mapeable y la barra de colores. En este caso, no use ninguna de las propiedades de los ejes kwargs.
Se sabe que algunos visores de gráficos vectoriales (svg y pdf) generan espacios en blanco entre los segmentos de la barra de colores. Esto se debe a errores en los visores, no en Matplotlib. Como solución alternativa, la barra de colores se puede representar con segmentos superpuestos:
cbar = colorbar() cbar.solids.set_edgecolor("face") draw()
Sin embargo, esto tiene consecuencias negativas en otras circunstancias, por ejemplo, con imágenes semitransparentes (alfa < 1) y extensiones de barras de colores; por lo tanto, esta solución alternativa no se usa de forma predeterminada (consulte el problema n.º 1188).
