Графики по данным из файла CSV

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

График по двум столбцам файла

Загрузите файл CSV в проект (или создайте его там). Первая строка называет столбцы. x= и y= выбирают их по имени, а col sep=comma говорит, что значения разделены запятыми.

На этой странице используется небольшой файл data-from-csv-weather.csv:

month,temp,rain,sd
1,1.2,44,0.8
2,2.0,38,0.7
3,5.6,41,0.9
...
12,2.3,46,0.8

Температура по месяцам из файла CSV

LaTeXПреамбула: \usepackage{pgfplots}КопироватьОткрыть в редакторе (откроется в новой вкладке)

\begin{tikzpicture}
  \begin{axis}[xlabel={Month}, ylabel={Temperature ($^\circ$C)}, xtick={1,...,12}]
    \addplot table[x=month, y=temp, col sep=comma] {data-from-csv-weather.csv};
  \end{axis}
\end{tikzpicture}

Файлы в папках тоже работают: пишите путь так, как он выглядит в проекте, например {data/weather.csv}.

Несколько столбцов, столбцы погрешностей и вычисляемые значения

Читайте один и тот же файл по разу на каждую серию. y error= берёт планки погрешностей из столбца, а y expr= вычисляет значение по строке, где \thisrow{name} обозначает столбец.

Две серии из одного файла

LaTeXПреамбула: \usepackage{pgfplots}КопироватьОткрыть в редакторе (откроется в новой вкладке)

\begin{tikzpicture}
  \begin{axis}[xlabel={Month}, ylabel={Value}, legend pos=north west, ymin=0]
    \addplot+[error bars/.cd, y dir=both, y explicit]
      table[x=month, y=temp, y error=sd, col sep=comma] {data-from-csv-weather.csv};
    \addplot+[mark=none, dashed]
      table[x=month, y expr=\thisrow{rain}/2, col sep=comma] {data-from-csv-weather.csv};
    \legend{Temperature ($^\circ$C), Rain / 2 (mm)}
  \end{axis}
\end{tikzpicture}

Одно чтение таблицы

\pgfplotstableread читает файл в макрос, который затем может использовать любой \addplot. Так короче, когда одна таблица питает несколько графиков.

\pgfplotstableread[col sep=comma]{data-from-csv-weather.csv}\weather
\begin{tikzpicture}
  \begin{axis}[ybar, bar width=6pt, ymin=0, xlabel={Month}, ylabel={Rain (mm)},
               xtick={1,...,12}, enlarge x limits=0.06]
    \addplot table[x=month, y=rain] {\weather};
  \end{axis}
\end{tikzpicture}

Данные внутри документа: filecontents

Небольшие наборы данных могут жить прямо в файле .tex. filecontents* записывает своё содержимое в файл с этим именем, который потом читает \addplot table. Окружение стоит в преамбуле, до \begin{document}.

\documentclass{article}
\usepackage{pgfplots}
\begin{filecontents*}{speed.dat}
t   v
0   0
1   4.4
2   8.1
3   11.0
4   13.2
\end{filecontents*}
\begin{document}
\begin{tikzpicture}
  \begin{axis}[xlabel={Time (s)}, ylabel={Speed (m/s)}]
    \addplot table[x=t, y=v] {speed.dat};
  \end{axis}
\end{tikzpicture}
\end{document}

Здесь столбцы разделены пробелами, как принято в pgfplots по умолчанию, поэтому col sep не нужен.

Параметры таблицы

Пустые ячейки, nan и inf считаются пропущенными значениями и не рисуются.

Когда что-то идёт не так

Если файл .csv читается без col sep=comma, Scissor LaTeX всё равно находит запятые, и график рисуется, но вкладка «Проблемы» просит добавить параметр. Установленный TeX не стал бы угадывать, и там график не получился бы.

\begin{tikzpicture}
  \begin{axis}[width=6cm, height=4.5cm]
    \addplot table[x=month, y=temp] {data-from-csv-weather.csv};
  \end{axis}
\end{tikzpicture}

Если файла нет в проекте, этот график пропускается. Ось всё равно рисуется, а вкладка «Проблемы» называет отсутствующий файл.

\begin{tikzpicture}
  \begin{axis}[width=6cm, height=4.5cm]
    \addplot table[col sep=comma] {results.csv};
  \end{axis}
\end{tikzpicture}

Чем это отличается от установленного TeX

Всё здесь записано в синтаксисе pgfplots, поэтому файлы компилируются и в установленном TeX. Руководство: ctan.org/pkg/pgfplots. О планках погрешностей из столбцов читайте на странице планок погрешностей.

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