matplotlib

matplotlib é a biblioteca fundamental de plotagem do Python. Controle figuras, eixos e todos os elementos gráficos para gráficos estáticos de qualidade para publicação.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

import matplotlib.pyplot as plt
 
fig, ax = plt.subplots(figsize=(8, 4))
ax.plot([1, 2, 3], [4, 1, 3], label="Series A")
ax.set(xlabel="Month", ylabel="Revenue", title="Q1 Performance")
ax.legend()
fig.savefig("q1.png", dpi=150, bbox_inches="tight")
plt.close(fig)

Quando usar isso:

• Controle granular sobre layout, fontes e anotações
• PNG/PDF/SVG estático para relatórios e artigos
• Incorporar gráficos em jobs Python em lote sem um navegador
• Camada base para seaborn, pandas .plot ou visualizações personalizadas

Exemplo de Trabalho

import matplotlib.pyplot as plt
import numpy as np
 
months = np.arange(1, 13)
east = np.array([120, 130, 125, 140, 150, 155, 160, 158, 162, 170, 175, 180])
west = np.array([100, 105, 110, 108, 115, 120, 118, 122, 125, 130, 128, 135])
 
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4), sharey=True)
 
ax1.plot(months, east, marker="o", color="#2c7bb6", label="East")
ax1.plot(months, west, marker="s", color="#fdae61", label="West")
ax1.set(xlabel="Month", ylabel="Revenue ($k)", title="Regional Trends")
ax1.legend()
ax1.grid(True, alpha=0.3)
 
width = 0.35
ax2.bar(months - width/2, east, width, label="East", color="#2c7bb6")
ax2.bar(months + width/2, west, width, label="West", color="#fdae61")
ax2.set(xlabel="Month", title="Side-by-Side Comparison")
ax2.legend()
 
fig.suptitle("2025 Revenue Dashboard", fontsize=14)
fig.tight_layout()
fig.savefig("dashboard.png", dpi=200, bbox_inches="tight")
plt.close(fig)

O que isso demonstra:

• API orientada a objetos com fig e ax explícitos
• Subplots com sharey para escalas comparáveis
• Gráficos mistos de linha e barras agrupadas em uma única figura
• suptitle, tight_layout e exportação de alta DPI

Mergulho Profundo

Como Funciona

• Figure contém os elementos gráficos (artists); Axes fornece o sistema de coordenadas e os métodos de plotagem.
• A máquina de estados do pyplot (plt.plot) funciona bem em notebooks; prefira a abordagem OO em módulos.
• Os elementos gráficos (linhas, patches, texto) são atualizados ao chamar draw - savefig renderiza fora da tela.
• Estilos estão em matplotlib.rcParams ou em folhas de estilo.

Métodos Comuns de Axes

Notas de Python

import matplotlib.pyplot as plt
 
# Non-interactive backend for servers
import matplotlib
matplotlib.use("Agg")
 
# Date formatting on x-axis
import matplotlib.dates as mdates
ax.xaxis.set_major_formatter(mdates.DateFormatter("%Y-%m"))

Armadilhas

• Vazamento de estado do pyplot entre células - figuras anteriores "vazam" para novos gráficos. Correção: sempre use fig, ax = plt.subplots() e plt.close(fig).
• tight_layout esquecido - rótulos dos eixos são cortados em PNGs salvos. Correção: fig.tight_layout() ou constrained_layout=True na criação.
• Tamanhos de marcadores enormes em scatter - obscurecem a densidade. Correção: diminua s e aumente alpha.
• Loop sem close - milhares de figuras esgotam a RAM. Correção: use plt.close(fig) em cada iteração.
• DPI incorreto para impressão - 72 DPI parece embaçado no papel. Correção: use 300 DPI para PNG ou PDF vetorial.

Alternativas

FAQs

import matplotlib.pyplot as plt
plt.rcParams.update({"font.size": 12})

ax.tick_params(axis="x", rotation=45)

ax2 = ax.twinx()
ax2.plot(x, other_series, color="tab:orange")

fig, axes = plt.subplots(2, 2, figsize=(8, 8))
axes[0, 1].plot(x, y)

ax.set_yscale("log")

Relacionados

• seaborn - gráficos estatísticos sobre matplotlib
• Noções Básicas de Visualização - seleção de gráficos
• Plotagem de Grandes Volumes de Dados - subamostragem
• Melhores Práticas de Visualização - eixos honestos

Versões da Pilha: Esta página foi escrita para Python 3.14.0 (estável 3.14, manutenção 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+, e uv 0.6+.