More than 5 years have passed since last update.

p6-Chart-Gnuplotを作った話

Last updated at 2017-12-17Posted at 2017-12-11

こんにちは、11日目の投稿になります。

Advent of Codeばっかり解いててもつまらないので、今日は私の作ったp6-Chart-Gnuplotをどういう感じで作っていったのか紹介しようと思います。

1. モチベーション

去年のアドベントカレンダーでも紹介記事があったように、Perl6のグラフ描画ライブラリにはSVG::Plotがありました。
しかし、matplotlibやgnuplotなどの高機能な描画ライブラリと比較すると、どうしても力不足な印象が否めなせんでした。
そこで、Perl6初の本格的な描画ライブラリとして、gnuplotのバインダを作ることにしました。

2. コードリーディング

描画ライブラリというものを全く作ったことがありませんでした。
いろいろ着手していく前に、ほかの競合ライブラリのコードリーディングをやって知見を貯めていくところから始めました。

具体的には、まず開発規模が近そうなのでperl, goのgnuplotのライブラリを読みました。
そして、これだけ使われてればさすがにいい感じのテストが書いてあるだろうと思ってmatplotlibを読みました。

Chart-Gnuplot

大先輩であるPerl 5のライブラリです。
プロダクトが出来上がるとPerlと確実に比較されるので読むことにしました。

このライブラリは下記のような特徴があるようでした:
細かな描画オプションはChart::Gnuplot::DataSetに格納する
thawに描画オプションを読み取る操作をやらせる
実行のためのスクリプトはファイルにいったん保存する: https://metacpan.org/source/KWMAK/Chart-Gnuplot-0.23/lib/Chart/Gnuplot.pm#L236
executeでシステムコールによってgnuplotコマンドを実行する
あらかじめファイル保存されたスクリプトとテスト時に生成保存されたスクリプトのdiffを取ることでテストしている

go-gnuplot

規模が小さいので手が付けやすそうでした

このライブラリは下記のような特徴があるようでした:
二回目以降のplot呼び出しはreplotで処理する
プロットする点のデータはファイル書き出しする: https://github.com/sbinet/go-gnuplot/blob/master/gnuplot.go#L195-L208
Cmdを通じてgnuplotのsubprocessに命令を送る: https://github.com/sbinet/go-gnuplot/blob/master/gnuplot.go#L85
+ PlotXYなどの関数も最終的にはCmdを呼び出すことで命令を送る: https://github.com/sbinet/go-gnuplot/blob/master/gnuplot.go#L194
+ PloxXYなどの専用のインタフェースの用意されていない場合は、クライアントはCmdに命令文をベタに指定することで処理を行う
テストがない :)

glot

goのライブラリで特に人気があるようなので読むことにしました。

このライブラリは下記のような特徴があるようでした:
- ところどころAPIは違うかもしれないが、おそらくgo-gnuplotがベースになっていてアプローチがかなり近い
- エラー処理だけはテストされている

matplotlib

単体テストを一体どのようにおこなっているのか。この一点にだけ関心があったので読みました。

結論から言うと、maptlotlibで行われている単体テストは仕様化テストです。コードをそこまでしっかりと読まなくても下記ページに説明がありました:
https://matplotlib.org/devel/testing.html

具体的には下記の手順になっているようです:

今後テストに使用したい描画オプションを指定してmatplotlibによりsvg画像を生成する(※pngはファイルが大きいので結局svgしか使わない)
ベースとなるイメージを保存するためのフォルダにそのsvg画像をコピーする
1)で指定した描画オプションと同様のオプションを指定して画像を生成し、2)のフォルダ内の対応する画像とのdiffを取る

3. フレームワーク

コードリーディングした結果を参考にして、どういう枠組みで解くべきか決めました:

基本的にgo-gnuplotのアプローチを採用する
- i.e. 専用のインタフェースがある場合はそれで、そうじゃない場合はベタに命令文を指定してもらう
ファイル書き込みはダサいのでやらない
テストはChart-Gnuplot(Perl)の方式でおこなう。ただしファイル書き込みは行わないので、変数に命令文を保存して、想定した命令文と一定しているかどうかをチェックするようにする