HOWTO · Matplotlib

Como alterar o espaço entre subgráficos no Matplotlib

Use tight_layout(), subplots_adjust(), subplot_tool() ou constrained_layout=True para melhorar o espaçamento em figuras do Matplotlib com muitos subgráficos.

Nesta página

Para facilitar a leitura de uma figura do Matplotlib com muitos subgráficos, escolha o controle de layout adequado ao seu fluxo de trabalho: use tight_layout() para ajustar automaticamente o espaço para os elementos dos subgráficos, plt.subplots_adjust() para definir o espaçamento e as margens da figura, plt.subplot_tool() para fazer ajustes interativos ou constrained_layout=True ao criar os subgráficos. Esses controles ajustam o layout; se cada eixo precisar de mais espaço, considere também aumentar o tamanho da figura ou alterar o número de linhas e colunas.

Use tight_layout() para evitar a sobreposição dos subgráficos

Chame fig.tight_layout() depois de adicionar os gráficos, rótulos e títulos. Esse método ajusta a posição dos subgráficos para abrir espaço para elementos como rótulos dos eixos e títulos. É uma boa primeira opção quando a disposição padrão fica apertada, embora não resolva todos os layouts, especialmente quando a figura tem elementos decorativos complexos.

O exemplo completo a seguir cria quatro gráficos com títulos em uma grade de 2 por 2 e, em seguida, aplica o ajuste automático. Os títulos mostrados pelo código inalterado estão em inglês:

import numpy as np
import matplotlib.pyplot as plt

x = np.linspace(-3, 3, 100)
series = [
    (np.sin(x), "Sine function"),
    (np.cos(x), "Cosine function"),
    (1 / (1 + np.exp(-x)), "Sigmoid function"),
    (np.exp(x), "Exponential function"),
]

fig, axes = plt.subplots(2, 2)
for ax, (values, title) in zip(axes.flat, series):
    ax.plot(x, values)
    ax.set_title(title)

fig.tight_layout()
plt.show()

Execute o exemplo em um ambiente Python com NumPy e Matplotlib instalados. O layout é ajustado depois que os títulos e os dados dos gráficos são adicionados.

Defina o espaçamento e as margens dos subgráficos com plt.subplots_adjust()

Use plt.subplots_adjust() para controlar diretamente os intervalos entre os eixos ou o espaço ao redor da grade. wspace define o intervalo horizontal como uma fração da largura média dos eixos; hspace define o intervalo vertical como uma fração da altura média dos eixos. Os valores left, right, bottom e top definem as bordas da área dos subgráficos como frações da largura ou da altura da figura.

O exemplo a seguir usa a mesma disposição com quatro gráficos e deixa um espaço maior entre as linhas:

import numpy as np
import matplotlib.pyplot as plt

x = np.linspace(-3, 3, 100)
series = [
    (np.sin(x), "Sine function"),
    (np.cos(x), "Cosine function"),
    (1 / (1 + np.exp(-x)), "Sigmoid function"),
    (np.exp(x), "Exponential function"),
]

fig, axes = plt.subplots(2, 2)
for ax, (values, title) in zip(axes.flat, series):
    ax.plot(x, values)
    ax.set_title(title)

fig.subplots_adjust(left=0.12, right=0.95, bottom=0.12, top=0.9, wspace=0.25, hspace=0.4)
plt.show()

Aumente wspace ou hspace para ampliar os intervalos correspondentes. Ajuste os quatro valores das bordas para reservar mais espaço ao redor da grade de subgráficos, por exemplo, quando os rótulos precisarem de mais espaço. Essas configurações controlam a disposição dos eixos dentro da figura; altere figsize em plt.subplots() se a figura inteira precisar de mais espaço.

Ajuste o layout dos subgráficos de forma interativa com plt.subplot_tool()

plt.subplot_tool() abre uma janela do Matplotlib com controles para ajustar o espaçamento e as margens dos subgráficos. A ferramenta é útil para ajustar visualmente uma figura e depois transferir as configurações escolhidas para o script. Ela exige um backend interativo do Matplotlib e um ambiente gráfico; não serve para ajustar uma imagem estática nem para uma sessão de plotagem sem interface gráfica.

Em uma sessão interativa com interface gráfica, crie a figura e chame plt.subplot_tool(fig), passando essa figura. Essa chamada depende de um gerenciador de canvas do Matplotlib associado a uma barra de ferramentas. Backends não interativos, como o usado para renderização sem interface gráfica, não fornecem essa barra, então a ferramenta não pode ser aberta neles. Por isso, o exemplo interativo não é apresentado como um script executável sem interface gráfica.

Use os controles da ferramenta para alterar os parâmetros dos subgráficos enquanto visualiza a figura. Quando a disposição estiver adequada, aplique no código os valores correspondentes de wspace, hspace e das margens com plt.subplots_adjust() para obter resultados reproduzíveis.

Habilite constrained_layout=True ao criar subgráficos

Para que o espaço da figura seja organizado automaticamente durante a renderização, passe constrained_layout=True ao chamar plt.subplots(). O mecanismo de layout leva em conta elementos dos subgráficos, como títulos e rótulos. Habilite essa opção ao criar a figura: ela foi projetada para gerenciar o layout durante a renderização, mas elementos decorativos complexos ainda podem exigir ajustes manuais. Consulte o guia de layout constrained do Matplotlib para obter mais detalhes.

import numpy as np
import matplotlib.pyplot as plt

a = np.linspace(0, 5, 100)
figure, axes = plt.subplots(2, 2, constrained_layout=True)

axes[0, 0].plot(a, np.exp(a))
axes[0, 1].plot(a, np.sin(a))
axes[1, 0].plot(a, np.cos(a))
axes[1, 1].plot(a, a ** 2)

for index, ax in enumerate(axes.flat, start=1):
    ax.set_title(f"Subplot {index}")

plt.show()

As quatro abordagens ajudam a organizar o layout dos subgráficos, mas atendem a fluxos de trabalho diferentes: use tight_layout() para um ajuste automático rápido depois de adicionar o conteúdo, plt.subplots_adjust() para definir valores explicitamente, plt.subplot_tool() para ajustes interativos e constrained_layout=True ao criar uma figura que deve gerenciar o espaçamento automaticamente.