matplotlib.pyplot

matplotlib.pyploté uma interface baseada em estado para matplotlib. Ele fornece uma forma de plotagem implícita, semelhante ao MATLAB. Ele também abre figuras em sua tela e atua como o gerenciador da GUI de figuras.

pyplot destina-se principalmente a plotagens interativas e casos simples de geração programática de plotagens:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
plt.plot(x, y)

A API orientada a objeto explícita é recomendada para plotagens complexas, embora pyplot ainda seja geralmente usado para criar a figura e frequentemente os eixos na figura. Veja pyplot.figure, pyplot.subplots, e pyplot.subplot_mosaicpara criar figuras, e API de Axes para os métodos de plotagem em um Axes:

import numpy as np
import matplotlib.pyplot as plt

x = np.arange(0, 5, 0.1)
y = np.sin(x)
fig, ax = plt.subplots()
ax.plot(x, y)

Consulte Matplotlib Application Interfaces (APIs) para obter uma explicação das compensações entre as interfaces implícitas e explícitas.

Comandos de plotagem

acorr	Plote a autocorrelação de x .
angle_spectrum	Trace o espectro do ângulo.
annotate	Anote o ponto xy com text text .
arrow	Adicione uma seta aos eixos.
autoscale	Escale automaticamente a exibição do eixo para os dados (alternar).
axes	Adicione um eixo à figura atual e torne-o o eixo atual.
axhline	Adicione uma linha horizontal ao longo dos eixos.
axhspan	Adicione uma extensão horizontal (retângulo) entre os eixos.
axis	Método de conveniência para obter ou definir algumas propriedades do eixo.
axline	Adicione uma linha reta infinitamente longa.
axvline	Adicione uma linha vertical nos eixos.
axvspan	Adicione uma extensão vertical (retângulo) entre os eixos.
bar	Faça um gráfico de barras.
bar_label	Rotule um gráfico de barras.
barbs	Traçar um campo 2D de farpas.
barh	Faça um gráfico de barra horizontal.
box	Ativa ou desativa a caixa de eixos nos eixos atuais.
boxplot	Desenhe um gráfico de caixa e bigodes.
broken_barh	Trace uma sequência horizontal de retângulos.
cla	Limpe os eixos atuais.
clabel	Rotule um gráfico de contorno.
clf	Limpe a figura atual.
clim	Defina os limites de cores da imagem atual.
close	Feche uma janela de figura.
cohere	Trace a coerência entre x e y .
colorbar	Adicione uma barra de cores a um gráfico.
contour	Traçar linhas de contorno.
contourf	Plotar contornos preenchidos.
csd	Plote a densidade espectral cruzada.
delaxes	Remova um Axes(padrão para os eixos atuais) de sua figura.
draw	Redesenhe a figura atual.
draw_if_interactive	Redesenhe a figura atual se estiver no modo interativo.
errorbar	Plote y versus x como linhas e/ou marcadores com barras de erro anexadas.
eventplot	Traçar linhas paralelas idênticas nas posições dadas.
figimage	Adicione uma imagem sem reamostragem à figura.
figlegend	Coloque uma legenda na figura.
fignum_exists	Retorna se a figura com o id fornecido existe.
figtext	Adicione texto à figura.
figure	Crie uma nova figura ou ative uma figura existente.
fill	Traçar polígonos preenchidos.
fill_between	Preencha a área entre duas curvas horizontais.
fill_betweenx	Preencha a área entre duas curvas verticais.
findobj	Encontre objetos artísticos.
gca	Obtenha os eixos atuais.
gcf	Obtenha a figura atual.
gci	Obtenha o artista colorido atual.
get	Retorne o valor da propriedade de an Artistou imprima todos eles.
get_cmap	Obtenha uma instância de mapa de cores, padronizando os valores rc se o nome for Nenhum.
get_figlabels	Retorna uma lista de rótulos de figuras existentes.
get_fignums	Retorna uma lista de números de figuras existentes.
getp	Retorne o valor da propriedade de an Artistou imprima todos eles.
grid	Configure as linhas de grade.
hexbin	Faça um gráfico binning hexagonal 2D dos pontos x , y .
hist	Calcular e traçar um histograma.
hist2d	Faça um gráfico de histograma 2D.
hlines	Trace linhas horizontais em cada y de xmin a xmax .
imread	Ler uma imagem de um arquivo em uma matriz.
imsave	Salve uma matriz como um arquivo de imagem.
imshow	Exibir dados como uma imagem, ou seja, em um raster regular 2D.
install_repl_displayhook	Conecte-se ao gancho de exibição do shell atual.
ioff	Desative o modo interativo.
ion	Ative o modo interativo.
isinteractive	Retorna se os gráficos são atualizados após cada comando de plotagem.
legend	Coloque uma legenda nos eixos.
locator_params	Controle o comportamento dos principais localizadores de carrapatos.
loglog	Faça um gráfico com escala de log nos eixos x e y.
magnitude_spectrum	Traçar o espectro de magnitude.
margins	Defina ou recupere margens de escala automática.
matshow	Exibir uma matriz como uma matriz em uma nova janela de figura.
minorticks_off	Remova marcas menores dos eixos.
minorticks_on	Exiba marcas menores nos eixos.
pause	Execute o loop de eventos da GUI para intervalos de segundos.
pcolor	Crie um gráfico de pseudocor com uma grade retangular não regular.
pcolormesh	Crie um gráfico de pseudocor com uma grade retangular não regular.
phase_spectrum	Plote o espectro de fase.
pie	Plote um gráfico de pizza.
plot	Plote y versus x como linhas e/ou marcadores.
plot_date	[ Desanimado ] Gráfico coagindo o eixo a tratar flutuações como datas.
polar	Faça um gráfico polar.
psd	Plote a densidade espectral de potência.
quiver	Traçar um campo 2D de setas.
quiverkey	Adicione uma chave a um gráfico de aljava.
rc	Defina a corrente rcParams. group é o agrupamento para o rc, por exemplo, para lines.linewidtho grupo é lines, para axes.facecolor, o grupo é axes, e assim por diante. Grupo também pode ser uma lista ou tupla de nomes de grupo, por exemplo, ( xtick , ytick ). kwargs é um dicionário de pares nome/valor de atributo, por exemplo,::.
rc_context	Retorna um gerenciador de contexto para alterar temporariamente rcParams.
rcdefaults	Restaure a rcParamspartir do estilo padrão interno do Matplotlib.
rgrids	Obtenha ou defina as linhas de grade radiais no gráfico polar atual.
savefig	Salve a figura atual.
sca	Defina os eixos atuais para ax e a figura atual para o pai de ax .
scatter	Um gráfico de dispersão de y vs.
sci	Defina a imagem atual.
semilogx	Faça um gráfico com escala de log no eixo x.
semilogy	Faça um gráfico com escala de log no eixo y.
set_cmap	Defina o mapa de cores padrão e aplique-o à imagem atual, se houver.
set_loglevel	Defina o registrador raiz do Matplotlib e o nível do manipulador do registrador raiz, criando o manipulador se ele ainda não existir.
setp	Defina uma ou mais propriedades em um Artistou liste os valores permitidos.
show	Exibir todas as figuras abertas.
specgram	Traçar um espectrograma.
spy	Plote o padrão de dispersão de uma matriz 2D.
stackplot	Desenhe um gráfico de área empilhada.
stairs	Uma função constante passo a passo como uma linha com arestas delimitadoras ou um gráfico preenchido.
stem	Crie um gráfico de tronco.
step	Faça um gráfico de passos.
streamplot	Desenhe linhas de corrente de um fluxo vetorial.
subplot	Adicione um eixo à figura atual ou recupere um eixo existente.
subplot2grid	Crie uma subtrama em um local específico dentro de uma grade regular.
subplot_mosaic	Crie um layout de eixos com base em arte ASCII ou listas aninhadas.
subplot_tool	Abra uma janela de ferramenta de subtrama para uma figura.
subplots	Crie uma figura e um conjunto de subtramas.
subplots_adjust	Ajuste os parâmetros de layout da subtrama.
suptitle	Adicione um subtítulo centralizado à figura.
switch_backend	Feche todas as figuras abertas e defina o back-end do Matplotlib.
table	Adicionar uma tabela a um arquivo Axes.
text	Adicione texto aos eixos.
thetagrids	Obtenha ou defina as linhas de grade theta no gráfico polar atual.
tick_params	Altere a aparência de marcadores, rótulos de marcadores e linhas de grade.
ticklabel_format	Configure o ScalarFormatterusado por padrão para eixos lineares.
tight_layout	Ajuste o preenchimento entre e ao redor das subparcelas.
title	Defina um título para os eixos.
tricontour	Desenhe linhas de contorno em uma grade triangular não estruturada.
tricontourf	Desenhe regiões de contorno em uma grade triangular não estruturada.
tripcolor	Crie um gráfico de pseudocor de uma grade triangular não estruturada.
triplot	Desenhe uma grade triangular não estruturada como linhas e/ou marcadores.
twinx	Crie e retorne um segundo eixo que compartilhe o eixo x .
twiny	Crie e retorne um segundo eixo que compartilhe o eixo y .
uninstall_repl_displayhook	Desconecte-se do gancho de exibição do shell atual.
violinplot	Faça um enredo de violino.
vlines	Plote linhas verticais em cada x de ymin a ymax .
xcorr	Trace a correlação cruzada entre x e y .
xkcd	Ative o modo de desenho estilo esboço xkcd .
xlabel	Defina o rótulo para o eixo x.
xlim	Obtenha ou defina os limites x dos eixos atuais.
xscale	Defina a escala do eixo x.
xticks	Obtenha ou defina os locais e rótulos atuais do eixo x.
ylabel	Defina o rótulo para o eixo y.
ylim	Obtenha ou defina os limites y dos eixos atuais.
yscale	Defina a escala do yaxis.
yticks	Obtenha ou defina os locais e rótulos atuais do eixo y.

Outros comandos

connect	Vincule a função func ao evento s .
disconnect	Desconecte o retorno de chamada com id cid .
get_current_fig_manager	Retorna o gerenciador de figuras da figura atual.
ginput	Chamada de bloqueio para interagir com uma figura.
new_figure_manager	Crie uma nova instância do gerenciador de figuras.
waitforbuttonpress	Chamada de bloqueio para interagir com a figura.

Mapas de cores

Os mapas de cores estão disponíveis através do registro de mapas de cores matplotlib.colormaps. Por conveniência, este registro está disponível pyplotcomo

matplotlib.pyplot. mapas de cores

Contêiner para mapas de cores que são conhecidos pelo nome do Matplotlib.

Experimental

Embora esperemos que a API seja final, nós a marcamos formalmente como experimental para 3.5 porque queremos manter a opção de ainda adaptar a API para 3.6 caso seja necessário.

A instância do registro universal é matplotlib.colormaps. Não deve haver necessidade de os usuários instanciarem a ColormapRegistrysi mesmos.

O acesso de leitura usa uma interface semelhante a dict mapeando nomes para Colormaps:

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

Os s retornados Colormapsão cópias, para que sua modificação não altere a definição global do mapa de cores.

Mapas de cores adicionais podem ser adicionados via ColormapRegistry.register:

mpl.colormaps.register(my_colormap)

Além disso, existem funções de atalho para definir mapas de cores integrados; por exemplo plt.viridis(), é equivalente a plt.set_cmap('viridis').

matplotlib.pyplot. color_sequences

Contêiner para sequências de cores que são conhecidas pelo nome do Matplotlib.

A instância do registro universal é matplotlib.color_sequences. Não deve haver necessidade de os usuários instanciarem a ColorSequenceRegistry si mesmos.

O acesso de leitura usa uma interface semelhante a um dict, mapeando nomes para listas de cores:

import matplotlib as mpl
cmap = mpl.color_sequences['tab10']

As listas retornadas são cópias, de modo que sua modificação não altera a definição global da sequência de cores.

Sequências de cores adicionais podem ser adicionadas por meio de ColorSequenceRegistry.register:

mpl.color_sequences.register('rgb', ['r', 'g', 'b'])