Перейти к содержанию

pgfplots в Scissor LaTeX

Пакет pgfplots работает в Scissor LaTeX для большинства 2D-графиков, которые рисует собственный движок отрисовки: оси, линейные, точечные и столбчатые графики, формулы, таблицы и файлы CSV, логарифмические оси, планки погрешностей, легенды, groupplots, fill between и тепловые карты при виде сверху; 3D-виды, axis equal и таблицы pgfplotstable пока не поддерживаются.

Что делает пакет

pgfplots рисует графики по данным или формулам внутри рисунка TikZ. Вы открываете \begin{tikzpicture}\begin{axis}[...], добавляете по одному \addplot на каждый ряд, а pgfplots выбирает деления, легенду и цвета. Его параметры охватывают логарифмические оси, столбчатые диаграммы, планки погрешностей, цветовые карты и многое другое.

Scissor LaTeX не выполняет pgfplots. Верстальщик читает тот же код и сам рисует график в векторной графике, с подписями шрифтами вашего документа. Результат близко следует умолчаниям pgfplots, а исходный код без изменений компилируется в установленном TeX.

Что здесь работает

ВозможностьВ Scissor LaTeXПодробнее
axis с подписями, заголовком, легендой, сеткой, делениями, диапазонамиРаботаетОсновы pgfplots
Линии, маркеры, цвета, cycle lists, smooth, const plotРаботаетЛинейные графики
only marks, точечные диаграммыРаботаетТочечные диаграммы
ybar, xbar, столбцы с накоплением, nodes near coords, symbolic x coordsРаботаетСтолбчатые диаграммы
error bars/.cd, y explicit, +- (x, y)РаботаетПланки погрешностей
semilogyaxis, loglogaxis, xmode=logРаботаетЛогарифмические оси
groupplot с group style (библиотека groupplots)РаботаетГруппы графиков
\addplot table из строк в документе или из файла .csv/.dat в проектеРаботаетДанные из CSV
\addplot3 с view={0}{90}: surf, matrix plot, contour filled, colorbarРаботаетКонтурные графики и тепловые карты
fill between (библиотека fillbetween), name pathРаботает
\pgfplotsset{...}, стили, compat=РаботаетВедёт себя как compat=1.18, какое бы значение ни стояло.
\addplot3 с любым другим view (настоящее 3D)Не поддерживаетсяРисуется пустая ось с сообщением.
axis equalНе поддерживаетсяИгнорируется с сообщением; оси сохраняют собственные масштабы.
\pgfplotstabletypeset (pgfplotstable)Не поддерживаетсяПропускается с сообщением, а имя файла выводится.
Неизвестные параметрыПропускаетсяИгнорируются с сообщением, которое называет параметр; остальное рисуется.

Примеры

Столбчатая диаграмма с подписями значений:

Столбчатая диаграмма с nodes near coords

LaTeXПреамбула: \usepackage{pgfplots}Открыть в редакторе (откроется в новой вкладке)
\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}

Два ряда из таблицы, записанной внутри документа, с легендой:

Столбцы таблицы в документе

LaTeXПреамбула: \usepackage{pgfplots}Открыть в редакторе (откроется в новой вкладке)
\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}

Поверхность, видимая под углом, пока не рисуется. Ось остаётся пустой, а вкладка «Проблемы» объясняет почему:

3D-вид не рисуется

LaTeXПреамбула: \usepackage{pgfplots}Открыть в редакторе (откроется в новой вкладке)
\begin{tikzpicture}
  \begin{axis}[view={60}{30}, width=6cm]
    \addplot3[surf, domain=-2:2] {x^2 - y^2};
  \end{axis}
\end{tikzpicture}

Вкладка «Проблемы»: 3D plots are drawn only when seen from above (view={0}{90}) for now

Совместимость

  • Из установленного TeX сюда: большинство 2D-графиков выглядят так же, как там, с точностью до пункта-двух. Настоящие 3D-графики, axis equal и параметры вне поддерживаемого набора называются на вкладке «Проблемы».
  • Отсюда в установленный TeX: графики компилируются там без изменений с pgfplots. contour lua и contour gnuplot требуют там LuaLaTeX или gnuplot; contour filled не требует ни того, ни другого.

Полное руководство есть на CTAN: ctan.org/pkg/pgfplots. О рисунках без осей читайте на странице TikZ.

Вопросы и ответы

Нужно ли устанавливать pgfplots, чтобы пользоваться им здесь?

Нет. Пишите \usepackage{pgfplots} как обычно; Scissor LaTeX распознаёт код и рисует график в браузере.

Почему мой 3D-график пустой?

Пока рисуются только графики при виде сверху (view={0}{90}). Другие виды дают пустую ось и сообщение на вкладке «Проблемы».

Можно ли построить график по данным из файла CSV?

Да. Добавьте файл в проект и напишите \addplot table[x=a, y=b, col sep=comma] {file.csv};.

Каждый пример на этой странице верстается в Scissor LaTeX при сборке сайта. Обновлено 2026-11-07.