Nº de referência da API

Ao usar a biblioteca, você normalmente criará objetos Figure e Axes e chamará seus métodos para adicionar conteúdo e modificar a aparência.

  • matplotlib.figure: criação de eixos, conteúdo em nível de figura

  • matplotlib.axes: a maioria dos métodos de plotagem, rótulos de eixos, acesso ao estilo de eixo, etc.

Exemplo: Criamos uma Figura fige Eixos ax. Em seguida, chamamos métodos neles para plotar dados, adicionar rótulos de eixo e um título de figura.

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(0, 4, 0.05)
y = np.sin(x*np.pi)

fig, ax = plt.subplots(figsize=(3,2), constrained_layout=True)
ax.plot(x, y)
ax.set_xlabel('t [s]')
ax.set_ylabel('S [V]')
ax.set_title('Sine wave')
fig.set_facecolor('lightsteelblue')

( Código fonte , png )

../_images/index-11.png

Padrões de uso #

Abaixo descrevemos várias abordagens comuns para plotagem com Matplotlib. Consulte Interfaces de aplicativo (APIs) do Matplotlib para obter uma explicação das vantagens e desvantagens entre as APIs de usuário com suporte.

A API explícita #

Em seu núcleo, o Matplotlib é uma biblioteca orientada a objetos. Recomendamos trabalhar diretamente com os objetos se precisar de mais controle e personalização de suas plotagens.

Em muitos casos você vai criar um Figuree um ou mais Axesusando pyplot.subplotse a partir daí só trabalhará nesses objetos. No entanto, também é possível criar Figures explicitamente (por exemplo, ao incluí-los em aplicativos GUI).

Leitura adicional:

A API implícita #

matplotlib.pyploté uma coleção de funções que fazem o Matplotlib funcionar como o MATLAB. Cada função pyplot faz alguma alteração em uma figura: por exemplo, cria uma figura, cria uma área de plotagem em uma figura, plota algumas linhas em uma área de plotagem, decora a plotagem com rótulos, etc.

pyplotdestina-se principalmente a plotagens interativas e casos simples de geração programática de plotagens.

Leitura adicional:

A API pylab (desencorajada) #

Aviso

Como a importação pesada para o namespace global pode resultar em comportamento inesperado, o uso de pylab é fortemente desencorajado. Use matplotlib.pyplot em vez disso.

pylabé um módulo que inclui matplotlib.pyplot, numpy, numpy.fft, numpy.linalg, numpy.randome algumas funções adicionais, tudo dentro de um único namespace. Seu propósito original era imitar uma maneira de trabalhar semelhante ao MATLAB, importando todas as funções para o namespace global. Isso é considerado um estilo ruim hoje em dia.

Módulos #

Lista alfabética de módulos: