REFERÊNCIA RÁPIDA DE MATPLOTLIB
Figuras, eixos, gráficos e personalização
Gráficos Básicos
Gráfico de Linha
import matplotlib.pyplot as plt
x = [1, 2, 3, 4, 5]
y = [2, 4, 1, 8, 3]
plt.plot(x, y)
plt.show()
Atalhos de Gráfico Rápido
plt.plot(y) # x auto 0..N-1
plt.plot(x, y, "ro--") # red circles, dashed
plt.plot(x, y, "bs-") # blue squares, solid
Códigos de String de Formato
| `r` `g` `b` `k` | Vermelho, verde, azul, preto |
| `o` `s` `^` `D` | Marcadores: círculo, quadrado, triângulo, diamante |
| `-` `--` `-.` `:` | Sólido, tracejado, traço-ponto, pontilhado |
Subplots
Figura e Eixos
fig, ax = plt.subplots()
ax.plot(x, y)
ax.set_title("Single Plot")
plt.show()
Grade de Subplots
fig, axes = plt.subplots(2, 2, figsize=(8, 6))
axes[0, 0].plot(x, y)
axes[0, 1].bar(x, y)
axes[1, 0].scatter(x, y)
fig.tight_layout()
Eixos Compartilhados
fig, (ax1, ax2) = plt.subplots(1, 2,
sharey=True, figsize=(10, 4))
ax1.plot(x, y)
ax2.plot(x, y2)
Rótulos e Títulos
Rótulos de Eixo e Título
plt.plot(x, y)
plt.xlabel("Time (s)")
plt.ylabel("Value")
plt.title("Sensor Reading")
plt.show()
Rótulos no Estilo OO
fig, ax = plt.subplots()
ax.plot(x, y)
ax.set_xlabel("X"); ax.set_ylabel("Y")
ax.set_title("My Plot")
Anotações
ax.annotate("Peak", xy=(4, 8),
xytext=(3, 9),
arrowprops=dict(arrowstyle="->"))
Personalização
Cores e Estilos
plt.plot(x, y, color="#FF5733",
linewidth=2, linestyle="--")
plt.plot(x, y2, color="steelblue",
marker="o", markersize=5)
Tamanho da Figura e DPI
fig, ax = plt.subplots(figsize=(10, 6), dpi=100)
plt.rcParams["figure.figsize"] = (8, 5)
Folhas de Estilo
print(plt.style.available) # list all
plt.style.use("seaborn-v0_8")
plt.style.use("ggplot")
Barras e Histograma
Gráfico de Barras
labels = ["A", "B", "C", "D"]
values = [23, 45, 12, 37]
plt.bar(labels, values, color="teal")
plt.show()
Barras Agrupadas / Empilhadas
import numpy as np
x = np.arange(4); w = 0.35
plt.bar(x - w/2, v1, w, label="2024")
plt.bar(x + w/2, v2, w, label="2025")
plt.xticks(x, labels)
Histograma
data = np.random.randn(1000)
plt.hist(data, bins=30, edgecolor="black",
alpha=0.7)
plt.show()
Dispersão e Linha
Gráfico de Dispersão
plt.scatter(x, y, c="red", s=50,
alpha=0.6, edgecolors="black")
plt.show()
Dispersão com Mapa de Cores
sc = plt.scatter(x, y, c=values,
cmap="viridis", s=sizes)
plt.colorbar(sc, label="Intensity")
Múltiplas Linhas
plt.plot(x, y1, label="Train")
plt.plot(x, y2, label="Validation")
plt.legend()
plt.show()
Eixos e Marcações
Limites e Escala dos Eixos
ax.set_xlim(0, 10)
ax.set_ylim(-1, 1)
ax.set_xscale("log")
ax.set_yscale("log")
Marcações Personalizadas
ax.set_xticks([0, 1, 2, 3, 4])
ax.set_xticklabels(["Mon", "Tue", "Wed",
"Thu", "Fri"], rotation=45)
Grade
ax.grid(True, linestyle="--", alpha=0.5)
ax.grid(axis="y") # horizontal only
Legendas
Adicionando Legendas
ax.plot(x, y, label="Series A")
ax.plot(x, y2, label="Series B")
ax.legend(loc="upper right")
Posicionamento da Legenda
| `'best'` | Melhor posição automática (padrão) |
| `'upper left'` | Canto superior esquerdo |
| `'lower right'` | Canto inferior direito |
| `'center'` | Centro dos eixos |
| `bbox_to_anchor=(1, 1)` | Posicionar fora da área dos eixos |
Personalização da Legenda
ax.legend(fontsize=8, frameon=False,
ncol=2, title="Legend")
Salvando
Salvar em Arquivo
plt.savefig("plot.png", dpi=300,
bbox_inches="tight")
plt.savefig("plot.pdf")
plt.savefig("plot.svg", transparent=True)
Formatos Suportados
| PNG | Raster, melhor para web/tela |
| PDF | Vetor, melhor para impressão/artigos |
| SVG | Vetor, escalável para web |
| EPS | Vetor, periódicos científicos legados |
Salvar a partir do Objeto Figura
fig, ax = plt.subplots()
ax.plot(x, y)
fig.savefig("output.png", dpi=150,
facecolor="white")
Padrões Comuns
Eixos Duplos (Duas Escalas Y)
fig, ax1 = plt.subplots()
ax2 = ax1.twinx()
ax1.plot(x, temp, "r-", label="Temp")
ax2.plot(x, pressure, "b-", label="Pressure")
Preenchimento Entre Curvas
ax.fill_between(x, y_low, y_high,
alpha=0.3, color="blue")
Mapa de Calor com imshow
data = np.random.rand(10, 10)
plt.imshow(data, cmap="hot",
interpolation="nearest")
plt.colorbar()
Gráfico de Pizza
plt.pie(sizes, labels=labels,
autopct="%1.1f%%", startangle=90)
plt.axis("equal")