Noções básicas de pgfplots: gráficos em LaTeX com exemplos
Carregue o pgfplots, abra um tikzpicture com um axis dentro e adicione cada série de dados com \addplot, seja como lista de coordenadas, seja como fórmula.
O menor gráfico
Todo gráfico do pgfplots tem as mesmas três camadas: um tikzpicture, um axis dentro dele e um \addplot por série de dados. Carregue o pacote com \usepackage{pgfplots} no preâmbulo.
Quatro pontos ligados por uma linha
\begin{tikzpicture}
\begin{axis}
\addplot coordinates {(0,1) (1,3) (2,2) (3,4)};
\end{axis}
\end{tikzpicture}Os eixos escolhem sozinhos o intervalo e as marcações a partir dos dados. Um \addplot simples pega a cor e o marcador da lista de ciclo padrão: azul com marcadores redondos para a primeira série, vermelho com quadrados para a segunda, e assim por diante.
Plotando uma fórmula
Em vez de coordenadas, passe ao \addplot uma fórmula entre chaves. domain define o intervalo de x e samples, o número de pontos. Sem eles, o pgfplots usa o intervalo de -5 a 5 com 25 amostras.
Uma função com domain e samples
\begin{tikzpicture}
\begin{axis}
\addplot[blue, thick, domain=-2:2, samples=60] {x^3 - 2*x};
\end{axis}
\end{tikzpicture}As opções entre colchetes depois de \addplot definem o estilo daquela série. Quando você passa opções sem +, a série é desenhada em preto (ou na cor que você indicar) sem marcadores; \addplot+[...] mantém o estilo da lista de ciclo e acrescenta suas opções a ele.
Rótulos, título, legenda e grade
Estas opções vão no axis, então valem para o gráfico inteiro.
Rótulos dos eixos, título, legenda e grade
\begin{tikzpicture}
\begin{axis}[
title={Cooling of a cup of tea},
xlabel={Time (min)},
ylabel={Temperature ($^\circ$C)},
grid=major,
legend pos=north east,
]
\addplot coordinates {(0,80) (5,64) (10,53) (15,44) (20,38)};
\addlegendentry{Measured}
\addplot[red, domain=0:20, samples=40] {22 + 58*exp(-0.08*x)};
\addlegendentry{Model}
\end{axis}
\end{tikzpicture}
Rótulos são texto, então a matemática vai entre $ ... $, como num parágrafo. \addlegendentry depois de cada \addplot dá nome àquela série; você também pode listar todos os nomes no final com \legend{Measured, Model}.
Opções comuns dos eixos
| Opção | O que faz | No Scissor LaTeX |
|---|---|---|
xlabel, ylabel, title | texto ao longo dos eixos e acima do gráfico | Funciona |
xmin, xmax, ymin, ymax | fixam o intervalo visível | Funciona |
width, height | tamanho da figura inteira, por exemplo width=\linewidth | Funciona |
grid=major, grid=both | linhas de grade nas marcações principais (e secundárias) | Funciona |
xtick={0,1,2}, xticklabels={a,b,c} | escolhem as marcações e seus rótulos | Funciona |
legend pos=north west | north west, north east, south west, south east, outer north east | Funciona |
axis lines=left | um par de eixos em forma de L com setas, em vez de uma caixa | Funciona (também middle, center, none) |
enlargelimits=false | sem espaço extra em volta dos dados | Funciona |
axis equal | a mesma escala nos dois eixos | Ainda não suportado: ignorado com uma mensagem na aba Problemas |
A maioria das outras opções do manual do pgfplots também funciona; a página de gráficos de linhas lista estilos e marcadores. Uma opção que o renderizador não conhece é ignorada, e a aba Problemas indica qual é.
Tamanho e posicionamento
Por padrão, um gráfico tem cerca de 240 por 207 pontos, o padrão do pgfplots. Defina width e height no axis para mudar isso. Para dar legenda e número a um gráfico, coloque o tikzpicture dentro de um figure, como faria com uma imagem.
Um gráfico numa figura com legenda
\begin{figure}[h]
\centering
\begin{tikzpicture}
\begin{axis}[width=7cm, height=4.5cm, xlabel=$x$, ylabel=$x^2$]
\addplot[domain=0:2, samples=30] {x^2};
\end{axis}
\end{tikzpicture}
\caption{A parabola on $[0, 2]$.}
\label{fig:parabola}
\end{figure}
Figure~\ref{fig:parabola} shows the parabola.
\resizebox{0.5\linewidth}{!}{...} em volta de um único tikzpicture também funciona: a figura é redimensionada para essa largura.
O que muda em relação a uma instalação do TeX
Tudo nesta página também compila numa instalação do TeX com pgfplots. O manual completo está no CTAN: ctan.org/pkg/pgfplots.
Perguntas e respostas
Preciso instalar o pgfplots?
Não. Escreva \usepackage{pgfplots} normalmente. O Scissor LaTeX reconhece o pacote e desenha os gráficos sozinho, no navegador.
Por que o gráfico da minha função fica serrilhado?
Por padrão, o pgfplots liga 25 pontos. Acrescente samples=100 (ou mais) ao \addplot ou ao axis para uma curva mais suave, ou acrescente smooth para traçar uma curva pelos pontos.
Posso usar o pgfplots sem tikzpicture?
Não, em LaTeX o ambiente axis sempre fica dentro de um tikzpicture. O Scissor LaTeX segue a mesma regra, então seu código também compila em outros lugares.
Cada exemplo desta página é composto pelo Scissor LaTeX quando o site é gerado. Última atualização: 2026-11-07.