matplotlib.pyplot.colorbar #
- matplotlib.pyplot. colorbar ( mappable = None , cax = None , ax = None , ** kwargs ) [source] #
Adicione uma barra de cores a um gráfico.
- Parâmetros :
- mapeável
O
matplotlib.cm.ScalarMappable(ou seja,AxesImage,ContourSet, etc.) descrito por esta barra de cores. Este argumento é obrigatório para oFigure.colorbarmétodo, mas opcional para apyplot.colorbarfunção, que define o padrão para a imagem atual.Observe que é possível criar um
ScalarMappable"on-the-fly" para gerar barras de cores não anexadas a um artista desenhado anteriormente, por exemplofig.colorbar(cm.ScalarMappable(norm=norm, cmap=cmap), ax=ax)
- caixa
Axes, opcional Eixos nos quais a barra de cores será desenhada.
- ax
Axes, lista de eixos, opcional Um ou mais eixos pais dos quais o espaço para novos eixos de barra de cores será roubado, se cax for Nenhum. Isso não tem efeito se cax estiver definido.
- use_gridspec bool, opcional
Se cax for
None, um novo cax será criado como uma instância de Axes. Se ax for uma instância de Subplot e use_gridspec forTrue, cax será criado como uma instância de Subplot usando ogridspecmódulo.
- Devoluções :
- Barra de cor
Colorbar
- Barra de cor
- Outros Parâmetros :
- localização Nenhuma ou {'esquerda', 'direita', 'superior', 'inferior'}
O local, relativo aos eixos pais, onde os eixos da barra de cores são criados. Ele também determina a orientação da barra de cores (as barras de cores à esquerda e à direita são verticais, as barras de cores na parte superior e inferior são horizontais). Se Nenhum, o local virá da orientação se estiver definida (barras de cores verticais à direita, horizontais na parte inferior) ou padrão para 'direita' se a orientação não estiver definida.
- orientação Nenhuma ou {'vertical', 'horizontal'}
A orientação da barra de cores. É preferível definir a localização da barra de cores, pois isso também determina a orientação ; passar valores incompatíveis para localização e orientação gera uma exceção.
- flutuação da fração , padrão: 0,15
Fração dos eixos originais a serem usados para a barra de cores.
- encolher flutuante, padrão: 1.0
Fração pela qual multiplicar o tamanho da barra de cores.
- flutuação de aspecto , padrão: 20
Relação entre dimensões longas e curtas.
- pad float, padrão: 0,05 se vertical, 0,15 se horizontal
Fração dos eixos originais entre a barra de cores e os novos eixos da imagem.
- âncora (flutuar, flutuar), opcional
O ponto de ancoragem dos eixos da barra de cores. O padrão é (0,0, 0,5) se vertical; (0,5, 1,0) se horizontal.
- panchor (float, float) ou False , opcional
O ponto de ancoragem dos eixos pais da barra de cores. Se False , a âncora dos eixos pais permanecerá inalterada. O padrão é (1,0, 0,5) se vertical; (0,5, 0,0) se horizontal.
- estender {'nem', 'ambos', 'min', 'max'}
Faça extremidade(s) pontiaguda(s) para valores fora da faixa (a menos que 'nenhuma'). Eles são definidos para um determinado mapa de cores usando os métodos set_under e set_over do mapa de cores.
- extendfrac { Nenhum , 'auto', comprimento, comprimentos}
Se definido como Nenhum , as extensões mínima e máxima da barra de cores triangular terão um comprimento de 5% do comprimento da barra de cores interna (essa é a configuração padrão).
Se definido como 'auto', faz com que as extensões da barra de cores triangular tenham os mesmos comprimentos das caixas internas (quando o espaçamento é definido como 'uniforme') ou os mesmos comprimentos das respectivas caixas internas adjacentes (quando o espaçamento é definido como 'proporcional').
Se for escalar, indica o comprimento mínimo e máximo das extensões triangulares da barra de cores como uma fração do comprimento interno da barra de cores. Uma sequência de frações de dois elementos também pode ser fornecida, indicando os comprimentos mínimo e máximo das extensões da barra de cores, respectivamente, como uma fração do comprimento da barra de cores interior.
- extendrect bool
Se False , as extensões mínima e máxima da barra de cores serão triangulares (o padrão). Se True , as extensões serão retangulares.
- espaçamento {'uniforme', 'proporcional'}
Para barras de cores discretas (
BoundaryNormou contornos), 'uniforme' dá a cada cor o mesmo espaço; 'proporcional' torna o espaço proporcional ao intervalo de dados.- carrapatos Nenhum ou lista de carrapatos ou Localizador
Se Nenhum, os ticks são determinados automaticamente a partir da entrada.
- format Nenhum ou str ou Formatador
Se Nenhum,
ScalarFormatteré usado. Strings de formato, por exemplo,"%4.2e"ou"{x:.2e}", são suportadas. Uma alternativaFormatterpode ser dada em seu lugar.- drawedges bool
Se deseja desenhar linhas nos limites de cores.
- rótulo str
O rótulo no eixo longo da barra de cores.
- limites, valores Nenhum ou uma sequência
Se não for definido, o mapa de cores será exibido em uma escala de 0-1. Se forem sequências, os valores devem ter um comprimento 1 menor que os limites . Para cada região delimitada por entradas adjacentes nos limites , será utilizada a cor mapeada para o valor correspondente em values. Normalmente útil apenas para cores indexadas (ou seja,
norm=NoNorm()) ou outras circunstâncias incomuns.
Notas
Se mappable for um
ContourSet, sua extensão kwarg será incluída automaticamente.O encolher kwarg fornece uma maneira simples de dimensionar a barra de cores em relação aos eixos. Observe que, se cax for especificado, ele determinará o tamanho da barra de cores e encolherá e os kwargs de aspecto serão ignorados.
Para um controle mais preciso, você pode especificar manualmente as posições dos objetos de eixos nos quais o mapeável e a barra de cores são desenhados. Nesse caso, não use nenhuma das propriedades dos eixos kwargs.
Sabe-se que alguns visualizadores de gráficos vetoriais (svg e pdf) renderizam lacunas brancas entre os segmentos da barra de cores. Isso ocorre devido a bugs nos visualizadores, não no Matplotlib. Como solução alternativa, a barra de cores pode ser renderizada com segmentos sobrepostos:
cbar = colorbar() cbar.solids.set_edgecolor("face") draw()
No entanto, isso tem consequências negativas em outras circunstâncias, por exemplo, com imagens semitransparentes (alfa < 1) e extensões de barra de cores; portanto, essa solução alternativa não é usada por padrão (consulte o problema nº 1188).
