matplotlib#

Uma biblioteca de plotagem orientada a objetos.

Uma interface de procedimento é fornecida pelo módulo complementar pyplot, que pode ser importado diretamente, por exemplo:

import matplotlib.pyplot as plt

ou usando ipython:

ipython

no seu terminal, seguido de:

In [1]: %matplotlib
In [2]: import matplotlib.pyplot as plt

no prompt do shell ipython.

Na maioria das vezes, o uso direto da biblioteca orientada a objetos explícita é encorajado durante a programação; a interface pyplot implícita é principalmente para trabalhar interativamente. As exceções a essa sugestão são as funções pyplot pyplot.figure, pyplot.subplot, pyplot.subplotse pyplot.savefig, que podem simplificar muito a criação de scripts. Consulte Matplotlib Application Interfaces (APIs) para obter uma explicação das compensações entre as interfaces implícitas e explícitas.

Os módulos incluem:

matplotlib.axes

A Axesclasse. A maioria das funções pyplot são wrappers para Axesmétodos. O módulo axes é o nível mais alto de acesso OO à biblioteca.

matplotlib.figure

A Figureclasse.

matplotlib.artist

A Artistclasse base para todas as classes que desenham coisas.

matplotlib.lines

A Line2Dclasse para desenhar linhas e marcadores.

matplotlib.patches

Aulas para desenhar polígonos.

matplotlib.text

As aulas Texte .Annotation

matplotlib.image

As aulas AxesImagee .FigureImage

matplotlib.collections

Classes para desenho eficiente de grupos de linhas ou polígonos.

matplotlib.colors

Especificações de cores e criação de mapas de cores.

matplotlib.cm

Mapas de cores e a ScalarMappableclasse mixin para fornecer funcionalidade de mapeamento de cores para outras classes.

matplotlib.ticker

Cálculo de localizações de marca de escala e formatação de rótulos de escala.

matplotlib.backends

Um subpacote com módulos para várias bibliotecas GUI e formatos de saída.

O namespace base matplotlib inclui:

rcParams

Definições de configuração padrão; seus padrões podem ser substituídos usando um matplotlibrcarquivo.

use

Configurando o back-end do Matplotlib. Isso deve ser chamado antes de qualquer figura ser criada, porque não é possível alternar entre diferentes backends da GUI depois disso.

Matplotlib foi inicialmente escrito por John D. Hunter (1968-2012) e agora é desenvolvido e mantido por uma série de outros.

Ocasionalmente, a documentação interna (python docstrings) fará referência a MATLAB®, uma marca registrada da The MathWorks, Inc.

Gerenciamento de back-end #

matplotlib. use ( backend , * , force = True ) [fonte] #

Selecione o back-end usado para renderização e integração da GUI.

Parâmetros :
back- end str

O back-end para o qual alternar. Isso pode ser um dos nomes de back-end padrão, que não diferenciam maiúsculas de minúsculas:

  • backends interativos: GTK3Agg, GTK3Cairo, GTK4Agg, GTK4Cairo, MacOSX, nbAgg, QtAgg, QtCairo, TkAgg, TkCairo, WebAgg, WX, WXAgg, WXCairo, Qt5Agg, Qt5Cairo

  • back-ends não interativos: agg, cairo, pdf, pgf, ps, svg, template

ou uma string no formato: module://my.module.name.

Mudar para um back-end interativo não é possível se um loop de evento não relacionado já tiver sido iniciado (por exemplo, mudar para GTK3Agg se uma janela TkAgg já tiver sido aberta). Mudar para um back-end não interativo é sempre possível.

force bool, padrão: True

Se True (o padrão), gere um ImportErrorse o back-end não puder ser configurado (por falha na importação ou porque uma estrutura interativa de GUI incompatível já está em execução); se False, ignore silenciosamente a falha.

Veja também

Infra-estruturas
matplotlib.get_backend
matplotlib. get_backend ( ) [fonte] #

Retorna o nome do back-end atual.

Veja também

matplotlib.use
matplotlib. interativo ( b ) [fonte] #

Defina se deseja redesenhar após cada comando de plotagem (por exemplo pyplot.xlabel, ).

matplotlib. is_interactive ( ) [fonte] #

Retorna se deseja redesenhar após cada comando de plotagem.

Observação

Esta função destina-se apenas ao uso em back-ends. Os usuários finais devem usar pyplot.isinteractiveem vez disso.

Valores padrão e estilo #

matplotlib. rcParams [fonte] #

Uma instância de RcParamspara lidar com valores padrão do Matplotlib.

classe matplotlib. RcParams ( * args , ** kwargs ) [fonte] #

Um objeto de dicionário incluindo validação.

As funções de validação são definidas e associadas aos parâmetros rc em matplotlib.rcsetup.

A lista de rcParams é:

  • _internal.classic_mode

  • agg.path.chunksize

  • animação. taxa de bits

  • animação.codec

  • animation.convert_args

  • animation.convert_path

  • animação.embed_limit

  • animation.ffmpeg_args

  • animation.ffmpeg_path

  • animation.frame_format

  • animação.html

  • animador.escritor

  • axes.autolimit_mode

  • axes.axisbelow

  • axes.edgecolor

  • axes.facecolor

  • axes.formatter.limits

  • axes.formatter.min_exponent

  • axes.formatter.offset_threshold

  • axes.formatter.use_locale

  • axes.formatter.use_mathtext

  • axes.formatter.useoffset

  • axes.grid

  • axes.grid.axis

  • axes.grid.what

  • axes.labelcolor

  • axes.labelpad

  • axes.labelsize

  • axes.labelweight

  • axes.linewidth

  • axes.prop_cycle

  • axes.spines.bottom

  • axes.spines.left

  • axes.spines.right

  • axes.spines.top

  • axes.titlecolor

  • axes.titlelocation

  • axes.titlepad

  • axes.titlesize

  • axes.titleweight

  • axes.titley

  • axes.unicode_minus

  • axes.xmargin

  • axes.ymargin

  • axes.zmargin

  • axes3d.grid

  • Processo interno

  • backend_fallback

  • boxplot.bootstrap

  • boxplot.boxprops.color

  • boxplot.boxprops.linestyle

  • boxplot.boxprops.linewidth

  • boxplot.capprops.color

  • boxplot.capprops.linestyle

  • boxplot.capprops.linewidth

  • boxplot.flierprops.color

  • boxplot.flierprops.linestyle

  • boxplot.flierprops.linewidth

  • boxplot.flierprops.marker

  • boxplot.flierprops.markeredgecolor

  • boxplot.flierprops.markeredgewidth

  • boxplot.flierprops.markerfacecolor

  • boxplot.flierprops.markersize

  • boxplot.meanline

  • boxplot.meanprops.color

  • boxplot.meanprops.linestyle

  • boxplot.meanprops.linewidth

  • boxplot.meanprops.marker

  • boxplot.meanprops.markeredgecolor

  • boxplot.meanprops.markerfacecolor

  • boxplot.meanprops.markersize

  • boxplot.medianprops.color

  • boxplot.medianprops.linestyle

  • boxplot.medianprops.linewidth

  • boxplot.notch

  • boxplot.patchartist

  • boxplot.showbox

  • boxplot.showcaps

  • boxplot.showfliers

  • boxplot.showmeans

  • boxplot.vertical

  • boxplot.whiskerprops.color

  • boxplot.whiskerprops.linestyle

  • boxplot.whiskerprops.linewidth

  • boxplot.whiskers

  • contorno.algoritmo

  • contorno.corner_mask

  • contorno. largura de linha

  • contorno.negative_linestyle

  • data.autoformatador.dia

  • data.autoformatador.hora

  • data.autoformatador.microssegundo

  • data.autoformatador.minuto

  • data.autoformatador.mês

  • data.autoformatador.segundo

  • data.autoformatador.ano

  • data.converter

  • data.época

  • date.interval_multiples

  • docstring.hardcopy

  • errorbar.capsize

  • figura.autolayout

  • figure.constained_layout.h_pad

  • figure.constained_layout.hspace

  • figure.constained_layout.use

  • figure.constained_layout.w_pad

  • figure.constained_layout.wspace

  • figura.dpi

  • figura. cor da borda

  • figura.facecolor

  • figure.figsize

  • figura.quadro

  • figure.labelsize

  • figure.labelweight

  • figure.max_open_warning

  • figure.raise_window

  • figure.subplot.bottom

  • figure.subplot.hspace

  • figura.subtrama.esquerda

  • figura.subtrama.direita

  • figure.subplot.top

  • figure.subplot.wspace

  • figura.tamanho do título

  • figure.titleweight

  • fonte.cursiva

  • família de fontes

  • fonte.fantasia

  • fonte.monoespaço

  • fonte.sans-serif

  • fonte.serif

  • tamanho da fonte

  • font.stretch

  • estilo de fonte

  • fonte.variante

  • espessura da fonte

  • grade.alfa

  • grid.color

  • grid.linestyle

  • grid.linewidth

  • hachura.cor

  • hachura. largura de linha

  • hist.bins

  • imagem.aspecto

  • imagem.cmap

  • image.composite_image

  • imagem.interpolação

  • image.lut

  • imagem.origem

  • imagem.resample

  • interativo

  • keymap.back

  • keymap.copy

  • keymap.forward

  • mapa de teclas.tela cheia

  • mapa de teclas.grid

  • keymap.grid_minor

  • keymap.help

  • keymap.home

  • keymap.pan

  • keymap.quit

  • keymap.quit_all

  • keymap.save

  • keymap.xscale

  • keymap.yscale

  • mapa de teclas.zoom

  • legend.borderaxespad

  • legend.borderpad

  • legend.columnspace

  • legend.edgecolor

  • legend.facecolor

  • legend.fancybox

  • legenda. tamanho da fonte

  • legend.framealpha

  • legend.frameon

  • legenda.altura do punho

  • legend.handlelength

  • legend.handletextpad

  • legend.labelcolor

  • legend.labelspacing

  • legend.loc

  • legend.markerscale

  • legend.numpoints

  • legend.scatterpoints

  • legenda.sombra

  • legend.title_fontsize

  • linhas.antialiased

  • linhas.cor

  • linhas.dash_capstyle

  • linhas.dash_joinstyle

  • linhas.dashdot_pattern

  • linhas.dashed_pattern

  • linhas.dotted_pattern

  • linhas.estilo de linha

  • linhas. largura de linha

  • linhas.marcador

  • linhas.markeredgecolor

  • linhas.markeredgewidth

  • linhas.markerfacecolor

  • linhas.markersize

  • linhas.scale_dashes

  • linhas.solid_capstyle

  • linhas.solid_joinstyle

  • marcadores. estilo de preenchimento

  • mathtext.bf

  • mathtext.cal

  • textomatemático.padrão

  • mathtext.fallback

  • mathtext.fontset

  • mathtext.it

  • mathtext.rm

  • textomatemático.sf

  • textomatemático.tt

  • patch.antialiased

  • patch.edgecolor

  • patch.facecolor

  • patch.force_edgecolor

  • patch.linewidth

  • path.effects

  • path.simplify

  • path.simplify_threshold

  • path.sketch

  • path.snap

  • pcolor.shading

  • pcolormesh.snap

  • pdf.compression

  • pdf. tipo de fonte

  • pdf.heritcolor

  • pdf.use14corefonts

  • pgf.preâmbulo

  • pgf.rcfonts

  • pgf.texsystem

  • polaraxes.grid

  • ps.distiller.res

  • ps. tipo de fonte

  • ps.papersize

  • ps.useafm

  • ps.usedistiller

  • savefig.bbox

  • savefig.diretório

  • savefig.dpi

  • savefig.edgecolor

  • salvarfig.facecolor

  • savefig.format

  • savefig.orientation

  • savefig.pad_inches

  • savefig.transparent

  • scatter.edgecolors

  • marcador de dispersão

  • tipo de fonte svg

  • svg.hashsalt

  • svg.image_inline

  • text.antialiased

  • cor do texto

  • text.hinting

  • text.hinting_factor

  • text.kerning_factor

  • text.latex.preamble

  • text.parse_math

  • text.usetex

  • fuso horário

  • tk.window_focus

  • barra de ferramentas

  • webagg.address

  • webagg.open_in_browser

  • webagg.port

  • webagg.port_retries

  • xaxis.labellocation

  • xtick.alignment

  • xtick.bottom

  • xtick.color

  • xtick.direction

  • xtick.labelbottom

  • xtick.labelcolor

  • xtick.labelsize

  • xtick.labeltop

  • xtick.major.bottom

  • xtick.major.pad

  • xtick.major.size

  • xtick.major.top

  • xtick.major.width

  • xtick.minor.bottom

  • xtick.minor.pad

  • xtick.minor.size

  • xtick.minor.top

  • xtick.minor.visible

  • xtick.minor.width

  • xtick.top

  • yaxis.labellocation

  • ytick.alignment

  • ytick.color

  • ytick.direction

  • ytick.labelcolor

  • ytick.labelleft

  • ytick.labelright

  • ytick.labelsize

  • ytick.esquerda

  • ytick.major.left

  • ytick.major.pad

  • ytick.major.right

  • ytick.major.size

  • ytick.major.width

  • ytick.minor.left

  • ytick.minor.pad

  • ytick.minor.right

  • ytick.minor.size

  • ytick.minor.visible

  • ytick.minor.width

  • ytick.certo

Veja também

O arquivo matplotlibrc
find_all ( padrão ) [fonte] #

Retorne o subconjunto deste dicionário RcParams cujas chaves correspondem, usando re.search(), ao dado pattern.

Observação

As alterações no dicionário retornado não são propagadas para o dicionário RcParams pai.

copiar ( ) [fonte] #

Copie esta instância RcParams.

matplotlib. rc_context ( rc = Nenhum , fname = Nenhum ) [fonte] #

Retorna um gerenciador de contexto para alterar temporariamente rcParams.

O rcParams["backend"]não será redefinido pelo gerenciador de contexto.

Parâmetros :
rc dict

Os rcParams para definir temporariamente.

fname str ou path-like

Um arquivo com as configurações do Matplotlib rc. Se fname e rc forem fornecidos, as configurações de rc terão precedência.

Veja também

O arquivo matplotlibrc

Exemplos

Passando valores explícitos por meio de um dict:

with mpl.rc_context({'interactive': False}):
    fig, ax = plt.subplots()
    ax.plot(range(3), range(3))
    fig.savefig('example.png')
    plt.close(fig)

Carregando configurações de um arquivo:

with mpl.rc_context(fname='print.rc'):
    plt.plot(x, y)  # uses 'print.rc'
matplotlib. rc ( grupo , ** kwargs ) [fonte] #

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('lines', linewidth=2, color='r')

define a corrente rcParamse é equivalente a:

rcParams['lines.linewidth'] = 2
rcParams['lines.color'] = 'r'

Os seguintes aliases estão disponíveis para economizar digitação para usuários interativos:

Pseudônimo

Propriedade

'lw'

'espessura da linha'

'ls'

'estilo de linha'

'c'

'cor'

'fc'

'facecolor'

'ec'

'cor da borda'

'meu'

'markeredgewidth'

'aa'

'antialiased'

Assim, você poderia abreviar a chamada acima como:

rc('lines', lw=2, c='r')

Observe que você pode usar o recurso de dicionário kwargs do python para armazenar dicionários de parâmetros padrão. por exemplo, você pode personalizar a fonte rc da seguinte forma:

font = {'family' : 'monospace',
        'weight' : 'bold',
        'size'   : 'larger'}
rc('font', **font)  # pass in the font dict as kwargs

Isso permite alternar facilmente entre várias configurações. Use matplotlib.style.use('default')ou rcdefaults()para restaurar o padrão rcParamsapós as alterações.

Notas

Funcionalidade semelhante está disponível usando a interface dict normal, ou seja (mas não oferece suporte a abreviações ou agrupamento).rcParams.update({"lines.linewidth": 2, ...})rcParams.update

matplotlib. rcdefaults ( ) [fonte] #

Restaure a rcParamspartir do estilo padrão interno do Matplotlib.

Os estilos na lista negra rcParams(definidos em matplotlib.style.core.STYLE_BLACKLIST) não são atualizados.

Veja também

matplotlib.rc_file_defaults

Restaure o rcParamsdo arquivo rc originalmente carregado pelo Matplotlib.

matplotlib.style.use

Use um arquivo de estilo específico. Chame style.use('default')para restaurar o estilo padrão.

matplotlib. rc_file_defaults ( ) [fonte] #

Restaure a rcParamspartir do arquivo rc original carregado pelo Matplotlib.

Os estilos na lista negra rcParams(definidos em matplotlib.style.core.STYLE_BLACKLIST) não são atualizados.

matplotlib. rc_file ( fname , * , use_default_template = True ) [fonte] #

Atualização rcParamsdo arquivo.

Os estilos na lista negra rcParams(definidos em matplotlib.style.core.STYLE_BLACKLIST) não são atualizados.

Parâmetros :
fname str ou path-like

Um arquivo com as configurações do Matplotlib rc.

use_default_template bool

Se for True, inicialize com os parâmetros padrão antes de atualizar com os do arquivo fornecido. Se False, a configuração atual persiste e apenas os parâmetros especificados no arquivo são atualizados.

matplotlib. rc_params ( fail_on_error = Falso ) [fonte] #

Construa uma RcParamsinstância a partir do arquivo Matplotlib rc padrão.

matplotlib. rc_params_from_file ( fname , fail_on_error = False , use_default_template = True ) [source] #

Construir a RcParamspartir do arquivo fname .

Parâmetros :
fname str ou path-like

Um arquivo com as configurações do Matplotlib rc.

fail_on_error bool

Se True, gera um erro quando o analisador falha ao converter um parâmetro.

use_default_template bool

Se for True, inicialize com os parâmetros padrão antes de atualizar com os do arquivo fornecido. Se False, a classe de configuração contém apenas os parâmetros especificados no arquivo. (Útil para atualizar dicts.)

matplotlib. get_configdir ( ) [fonte] #

Retorne o caminho da string do diretório de configuração.

O diretório é escolhido da seguinte forma:

  1. Se a variável de ambiente MPLCONFIGDIR for fornecida, escolha-a.

  2. No Linux, siga a especificação XDG e procure primeiro em $XDG_CONFIG_HOME, se definido, ou $HOME/.config. Em outras plataformas, escolha $HOME/.matplotlib.

  3. Se o diretório escolhido existir e for gravável, use-o como o diretório de configuração.

  4. Caso contrário, crie um diretório temporário e use-o como o diretório de configuração.

matplotlib. matplotlib_fname ( ) [fonte] #

Obtenha a localização do arquivo de configuração.

A localização do arquivo é determinada na seguinte ordem

  • $PWD/matplotlibrc

  • $MATPLOTLIBRCse não for um diretório

  • $MATPLOTLIBRC/matplotlibrc

  • $MPLCONFIGDIR/matplotlibrc

  • No Linux,

    • $XDG_CONFIG_HOME/matplotlib/matplotlibrc(se $XDG_CONFIG_HOME estiver definido)

    • ou $HOME/.config/matplotlib/matplotlibrc(se $XDG_CONFIG_HOME não estiver definido)

  • Em outras plataformas, - $HOME/.matplotlib/matplotlibrcse $HOMEfor definido

  • Por fim, ele procura em $MATPLOTLIBDATA/matplotlibrc, que sempre deve existir.

matplotlib. get_data_path ( ) [fonte] #

Retorne o caminho para os dados do Matplotlib.

Registrando #

matplotlib. set_loglevel ( nível ) [fonte] #

Defina o registrador raiz do Matplotlib e o nível do manipulador do registrador raiz, criando o manipulador se ele ainda não existir.

Normalmente, deve-se ligar set_loglevel("info")ou set_loglevel("debug")obter informações adicionais sobre depuração.

Parâmetros :
level {"notset", "debug", "info", "warning", "error", "critical"}

O nível de log do manipulador.

Notas

Na primeira vez que essa função é chamada, um manipulador adicional é anexado ao manipulador raiz do Matplotlib; este manipulador é reutilizado todas as vezes e esta função simplesmente manipula o logger e o nível do manipulador.

Mapas de cores e sequências de cores #

matplotlib. mapas de cores [fonte] #

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)
matplotlib. color_sequences [fonte] #

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'])

Diversos #

classe matplotlib. MatplotlibDeprecationWarning [fonte] #

Uma classe para emitir avisos de descontinuação para usuários do Matplotlib.

matplotlib. get_cachedir ( ) [fonte] #

Retorne o caminho da string do diretório de cache.

O procedimento usado para localizar o diretório é o mesmo de _get_config_dir, exceto pelo uso de $XDG_CACHE_HOME/ $HOME/.cache.