Pular para o conteúdo

pgfplots no Scissor LaTeX

O pacote pgfplots funciona no Scissor LaTeX para a maioria dos gráficos 2D, desenhados por um renderizador próprio: eixos, gráficos de linha, dispersão e barras, fórmulas, tabelas e arquivos CSV, eixos logarítmicos, barras de erro, legendas, groupplots, fill between e mapas de calor vistos de cima; vistas 3D, axis equal e as tabelas do pgfplotstable ainda não são suportados.

O que o pacote faz

O pgfplots desenha gráficos a partir de dados ou fórmulas dentro de um desenho TikZ. Você abre \begin{tikzpicture}\begin{axis}[...], acrescenta um \addplot por série, e o pgfplots escolhe as marcações, a legenda e as cores. Suas opções cobrem eixos logarítmicos, gráficos de barras, barras de erro, mapas de cores e muito mais.

O Scissor LaTeX não executa o pgfplots. O compositor lê o mesmo código e desenha o gráfico ele mesmo, como gráfico vetorial, com os rótulos nas fontes do seu documento. O resultado segue de perto os padrões do pgfplots, e o código-fonte compila sem mudanças em uma instalação do TeX.

O que funciona aqui

RecursoNo Scissor LaTeXMais
axis com rótulos, título, legenda, grade, marcações, intervalosFuncionaNoções básicas de pgfplots
Linhas, marcadores, cores, cycle lists, smooth, const plotFuncionaGráficos de linha
only marks, gráficos de dispersãoFuncionaGráficos de dispersão
ybar, xbar, barras empilhadas, nodes near coords, symbolic x coordsFuncionaGráficos de barras
error bars/.cd, y explicit, +- (x, y)FuncionaBarras de erro
semilogyaxis, loglogaxis, xmode=logFuncionaEixos logarítmicos
groupplot com group style (biblioteca groupplots)FuncionaGráficos agrupados
\addplot table a partir de linhas no documento ou de um arquivo .csv/.dat do projetoFuncionaDados de CSV
\addplot3 com view={0}{90}: surf, matrix plot, contour filled, colorbarFuncionaCurvas de nível e mapas de calor
fill between (biblioteca fillbetween), name pathFunciona
\pgfplotsset{...}, estilos, compat=FuncionaComporta-se como compat=1.18, qualquer que seja a configuração.
\addplot3 com qualquer outra view (3D de verdade)Não suportadoUm eixo vazio é desenhado, com uma mensagem.
axis equalNão suportadoIgnorado com uma mensagem; os eixos mantêm as próprias escalas.
\pgfplotstabletypeset (pgfplotstable)Não suportadoPulado com uma mensagem, e o nome do arquivo é impresso.
Opções desconhecidasIgnoradoIgnoradas com uma mensagem que indica a opção; o resto é desenhado.

Exemplos

Um gráfico de barras com rótulos de valor:

Um gráfico de barras com nodes near coords

LaTeXPreâmbulo: \usepackage{pgfplots}Abrir no editor (abre em uma nova aba)
\begin{tikzpicture}
  \begin{axis}[ybar, bar width=12pt, ymin=0, ymax=52,
      symbolic x coords={Mon,Tue,Wed,Thu}, xtick=data,
      nodes near coords, enlarge x limits=0.2,
      ylabel={Visitors}, width=7cm, height=5cm]
    \addplot coordinates {(Mon,31) (Tue,44) (Wed,38) (Thu,27)};
  \end{axis}
\end{tikzpicture}

Duas séries lidas de uma tabela escrita dentro do documento, com legenda:

Colunas de uma tabela no documento

LaTeXPreâmbulo: \usepackage{pgfplots}Abrir no editor (abre em uma nova aba)
\begin{tikzpicture}
  \begin{axis}[xlabel={Week}, ylabel={Hours of practice},
      legend pos=north west, width=7cm, height=5cm]
    \addplot table [x=week, y=erika] {
      week erika john
      1    4     2
      2    6     3
      3    5     5
      4    8     6
    };
    \addlegendentry{Erika}
    \addplot table [x=week, y=john] {
      week erika john
      1    4     2
      2    6     3
      3    5     5
      4    8     6
    };
    \addlegendentry{John}
  \end{axis}
\end{tikzpicture}

Uma superfície vista em ângulo ainda não é desenhada. O eixo aparece vazio, e a aba Problemas explica o motivo:

Uma vista 3D não é desenhada

LaTeXPreâmbulo: \usepackage{pgfplots}Abrir no editor (abre em uma nova aba)
\begin{tikzpicture}
  \begin{axis}[view={60}{30}, width=6cm]
    \addplot3[surf, domain=-2:2] {x^2 - y^2};
  \end{axis}
\end{tikzpicture}

Aba Problemas: 3D plots are drawn only when seen from above (view={0}{90}) for now

Compatibilidade

  • De uma instalação do TeX para cá: a maioria dos gráficos 2D fica como lá, com diferença de um ou dois pontos. Gráficos 3D de verdade, axis equal e opções fora do conjunto suportado são indicados na aba Problemas.
  • Daqui para uma instalação do TeX: os gráficos compilam lá sem mudanças com o pgfplots. contour lua e contour gnuplot precisam de LuaLaTeX ou gnuplot lá; contour filled não precisa de nenhum dos dois.

O manual completo está no CTAN: ctan.org/pkg/pgfplots. Para desenhos sem eixos, veja TikZ.

Perguntas e respostas

Preciso instalar o pgfplots para usá-lo aqui?

Não. Escreva \usepackage{pgfplots} como de costume; o Scissor LaTeX reconhece o código e desenha o gráfico no navegador.

Por que meu gráfico 3D está vazio?

Por enquanto, só gráficos vistos de cima (view={0}{90}) são desenhados. Outras vistas dão um eixo vazio e uma mensagem na aba Problemas.

Posso fazer um gráfico com dados de um arquivo CSV?

Sim. Acrescente o arquivo ao projeto e escreva \addplot table[x=a, y=b, col sep=comma] {file.csv};.

Cada exemplo desta página é composto pelo Scissor LaTeX quando o site é gerado. Última atualização: 2026-11-07.