pgfplots

pgfplots — データの可視化とプロット

CTAN: https://ctan.org/pkg/pgfplots
マニュアル: texdoc pgfplots

セットアップ

\usepackage{pgfplots}
\pgfplotsset{compat=1.18}  % ALWAYS set this — enables latest features

% Optional libraries
\usepgfplotslibrary{fillbetween, groupplots, statistics, colorbrewer, polar}

基本的なプロット

\begin{tikzpicture}
\begin{axis}[
  xlabel={$x$},
  ylabel={$f(x)$},
  title={My Plot},
  grid=major,
]
  \addplot[blue, thick, domain=-3:3, samples=100] {x^2};
  \addlegend{$x^2$}
\end{axis}
\end{tikzpicture}

軸環境

環境	説明
axis	標準的な線形軸
semilogxaxis	x 軸を対数スケールにする
semilogyaxis	y 軸を対数スケールにする
loglogaxis	両軸を対数スケールにする
polaraxis	極座標（polar ライブラリが必要）

軸オプションのリファレンス

オプション	例	説明
xlabel	xlabel={Time (s)}	x 軸のラベル
ylabel	ylabel={Voltage}	y 軸のラベル
title	title={Results}	プロットのタイトル
xmin/xmax	xmin=0, xmax=10	軸の範囲
ymin/ymax	ymin=-1, ymax=1	軸の範囲
domain	domain=0:2*pi	デフォルトのプロット範囲
samples	samples=200	デフォルトのサンプル数
grid	grid=major	major、minor、both、none
legend pos	legend pos=north west	凡例の配置
width/height	width=10cm	軸の寸法
axis lines	axis lines=middle	box、left、middle、none
enlargelimits	enlargelimits=0.1	軸の範囲に余白を追加
xtick	xtick={0,1,...,5}	目盛り位置を指定
xticklabels	xticklabels={A,B,C}	目盛りラベルを指定
x tick label style	x tick label style={rotate=45}	目盛りラベルの書式設定
legend style	legend style={at={(0.5,-0.2)}}	凡例のカスタマイズ
cycle list name	cycle list name=color list	色の循環
scaled ticks	scaled ticks=false	目盛りのスケーリングを無効化
restrict y to domain	restrict y to domain=-10:10	極端な値をクリップ

プロットの種類と例

折れ線グラフ（式から作成）

\begin{axis}[domain=0:2*pi, samples=100, grid=major,
  legend pos=south west]
  \addplot[blue, thick] {sin(deg(x))};
  \addplot[red, thick, dashed] {cos(deg(x))};
  \legend{$\sin(x)$, $\cos(x)$}
\end{axis}

折れ線グラフ（データから作成）

\begin{axis}[xlabel=Year, ylabel=Value]
  \addplot coordinates {
    (2018, 10) (2019, 15) (2020, 12) (2021, 20) (2022, 25)
  };
\end{axis}

散布図

\begin{axis}[only marks, xlabel=$x$, ylabel=$y$]
  \addplot[mark=*, blue] coordinates {
    (1,2) (2,3.5) (3,2.8) (4,5.1) (5,4.2)
  };
  % Or with mark options:
  \addplot+[mark=o, mark size=3pt, red] coordinates { ... };
\end{axis}

棒グラフ

\begin{axis}[
  ybar,                    % vertical bars (xbar for horizontal)
  symbolic x coords={A, B, C, D},
  xtick=data,
  ylabel={Count},
  nodes near coords,       % value labels on bars
  bar width=15pt,
]
  \addplot coordinates {(A,20) (B,35) (C,30) (D,15)};
  \addplot coordinates {(A,25) (B,20) (C,40) (D,10)};
  \legend{2022, 2023}
\end{axis}

積み上げ棒グラフ

\begin{axis}[ybar stacked, symbolic x coords={Q1,Q2,Q3,Q4}, xtick=data]
  \addplot coordinates {(Q1,10) (Q2,15) (Q3,12) (Q4,18)};
  \addplot coordinates {(Q1,8)  (Q2,10) (Q3,15) (Q4,12)};
  \legend{Product A, Product B}
\end{axis}

ヒストグラム

\usepgfplotslibrary{statistics}

\begin{axis}[ybar interval, ylabel=Frequency, xlabel=Value]
  \addplot+[hist={bins=10, data min=0, data max=100}]
    table[y index=0] {data.csv};
\end{axis}

箱ひげ図

\usepgfplotslibrary{statistics}

\begin{axis}[boxplot/draw direction=y]
  \addplot[boxplot prepared={
    lower whisker=2, lower quartile=4,
    median=6, upper quartile=8, upper whisker=10
  }] coordinates {};
\end{axis}

面積塗りつぶし／曲線間の塗りつぶし

\usepgfplotslibrary{fillbetween}

\begin{axis}
  \addplot[name path=upper, blue, thick, domain=0:4] {x^2};
  \addplot[name path=lower, red, thick, domain=0:4] {x};
  \addplot[fill=blue!10] fill between[of=upper and lower, soft clip={domain=1:3}];
\end{axis}

エラーバー

\begin{axis}
  \addplot+[error bars/.cd, y dir=both, y explicit]
    coordinates {
      (1, 2) +- (0, 0.5)
      (2, 4) +- (0, 0.8)
      (3, 3) +- (0, 0.3)
    };
\end{axis}

3D サーフェス

\begin{axis}[view={45}{30}, xlabel=$x$, ylabel=$y$, zlabel=$z$,
  colormap/viridis]
  \addplot3[surf, domain=-2:2, domain y=-2:2, samples=25]
    {exp(-x^2 - y^2)};
\end{axis}

3D メッシュ

\begin{axis}[view={60}{30}]
  \addplot3[mesh, domain=-2:2, domain y=-2:2, samples=20]
    {sin(deg(x)) * cos(deg(y))};
\end{axis}

等高線

\begin{axis}[view={0}{90}]  % top-down view
  \addplot3[contour filled, domain=-2:2, domain y=-2:2, samples=30]
    {exp(-x^2 - y^2)};
\end{axis}

パラメトリックプロット

\begin{axis}[axis equal]
  \addplot[domain=0:360, samples=100, thick, blue]
    ({cos(x)}, {sin(x)});  % circle
\end{axis}

極座標プロット

\usepgfplotslibrary{polar}

\begin{polaraxis}
  \addplot[domain=0:360, samples=100, thick]
    {1 + cos(x)};  % cardioid
\end{polaraxis}

ファイルからのデータ

% CSV file: data.csv
% x, y
% 1, 2.3
% 2, 4.1
% ...

\begin{axis}
  \addplot table[col sep=comma, x=x, y=y] {data.csv};
  
  % TSV (default separator is space/tab)
  \addplot table[x index=0, y index=1] {data.tsv};
  
  % With expression on column
  \addplot table[x=time, y expr=\thisrow{value}*100] {data.csv};
\end{axis}

カラーマップ

% Built-in colormaps
colormap/hot, colormap/cool, colormap/viridis,
colormap/bluered, colormap/greenyellow, colormap/jet

% Custom
\pgfplotsset{
  colormap={mymap}{rgb255(0cm)=(0,0,180); rgb255(1cm)=(0,180,0); rgb255(2cm)=(180,0,0)}
}

% Colorbar
\begin{axis}[colorbar, colormap/viridis]

複数の軸

\begin{tikzpicture}
\begin{axis}[
  axis y line*=left, xlabel=Time, ylabel=Temperature,
  ymin=0, ymax=100,
]
  \addplot[blue, thick] coordinates {(1,20)(2,40)(3,60)(4,80)};
  \label{plot:temp}
\end{axis}

\begin{axis}[
  axis y line*=right, axis x line=none,
  ylabel=Pressure, ymin=0, ymax=10,
]
  \addplot[red, thick, dashed] coordinates {(1,2)(2,5)(3,3)(4,8)};
  \label{plot:press}
\end{axis}
\end{tikzpicture}

プロットのグループ化

\usepgfplotslibrary{groupplots}

\begin{tikzpicture}
\begin{groupplot}[
  group style={group size=2 by 2, horizontal sep=1.5cm, vertical sep=1.5cm},
  width=6cm, height=5cm,
]
  \nextgroupplot[title=Plot 1]
    \addplot {x};
  \nextgroupplot[title=Plot 2]
    \addplot {x^2};
  \nextgroupplot[title=Plot 3]
    \addplot {sqrt(x)};
  \nextgroupplot[title=Plot 4]
    \addplot {ln(x)};
\end{groupplot}
\end{tikzpicture}

注釈

\begin{axis}
  \addplot[blue, thick, domain=0:5] {x^2};
  
  % Pin annotation
  \node[pin=60:{Maximum}] at (axis cs:4, 16) {};
  
  % Arrow annotation
  \draw[->, thick] (axis cs:2, 10) -- (axis cs:3, 9)
    node[above, pos=0] {Note};
  
  % Vertical line
  \draw[dashed, gray] (axis cs:2.5, 0) -- (axis cs:2.5, 25);
  
  % Horizontal band
  \draw[fill=red!10, draw=none] (axis cs:0,5) rectangle (axis cs:5,10);
  
  % Text node
  \node at (axis cs:1, 20) {$f(x) = x^2$};
\end{axis}

マークのオプション

マーク	説明
*	塗りつぶし円
o	白抜き円
square*	塗りつぶし四角形
square	白抜き四角形
triangle*	塗りつぶし三角形
diamond*	塗りつぶしひし形
x	交差
+	プラス
star	星
none	マークなし

\addplot+[mark=triangle*, mark size=3pt, mark options={fill=red}] ...;

よくある落とし穴

問題	原因	対処法
"Dimension too large"	値または範囲が大きすぎる	restrict y to domain を使用し、範囲を確認する
compat 警告が表示される	\pgfplotsset{compat=..} がない	\pgfplotsset{compat=1.18} を追加する
三角関数の結果が正しくない	pgfplots は度数法を使用する	ラジアン入力には sin(deg(x)) を使用する
棒が重なって表示される	グループ化せずに複数の棒グラフを作成している	bar shift または凡例とともに ybar を使用する
凡例の位置が正しくない	デフォルトの位置が使われている	legend pos=north west などを設定する
3D プロットが遅すぎる	サンプル数が多すぎる	3D プロットでは samples を減らす
軸ラベルが切れている	バウンディングボックスが狭すぎる	trim axis left/right を使用するか、余白を広げる
曲線間の塗りつぶしが失敗する	パスに名前が付いていない	各プロットに name path=A を追加する
CSV 列のエラー	区切り文字が正しくない	CSV ファイルには col sep=comma を設定する
\addlegendentry の順序	対応する \addplot の後に置く必要がある	凡例項目を対応するプロットの直後に置く