5.1　サブタイトルを追加
棒グラフが2001年～2005年の売上高と経常利益を示すのは明白ですが、たとえば2003年に決算期変更を行い、売上高、経常利益ともに減っていたらどうでしょう？

BarSampleSubTitle1

上期と下期の業績が毎年均等ならまだマシですが、下期のほうにやや偏っている場合、あたかも極端な業績悪化のように見えてしまいます。

このようなとき、サブタイトルに2003年度がたとえば6ヶ月の決算であったことを明記しておけば、見る人にとって誤解を招きにくくなります。
もちろん、Webサイトで公開するとき、見せるとき、画像のキャプションとして説明しておけば十分ですが、画像だけを保存された場合、画像として残っているチャートの数字のみが一人歩きすることも考えられます。
せっかくですから、チャートに表示した内容の注釈はチャートの画像に埋め込んだほうが、見た人や画像ファイルをダウンロードした人も、あとになって忘れてしまうこともなく、よさそうです。

そのようなとき、チャートのタイトルに注釈を入れてもいいのですが、JFreeChartでは、それ以外にサブタイトルを表示する機能がありますので、それを使ってみましょう。

BarSampleSubTitle2

サブタイトルは、１つだけでなく複数定義することができ、BarSampleSubTitle2では、「2001-2005年度」と「（注：2003年は6ヶ月決算）」の２つが、JFreeChartにおけるサブタイトルです。

このデモを見て気づいた方もいるかもしれませんが、実はサブタイトルが表示される代わりに、凡例が消えてしまっています。これは、JFreeChartが凡例をサブタイトルの一部、さらにいえば、一番最初（0番目）のサブタイトルとして凡例を扱っているためです。
凡例を残したまま、サブタイトルを表示する方法は、このページの一番最後に示します。

以下、同様ですが、基本的にソースの1行1行にコメントを書いたので、プログラムの解説はソースファイルを見てください。

5.2　値を表示する
チャートは値の変化を概観するのに最適ですが、正確な値も同時に知りたい場合があります。このようなとき、Microsoft Excelであればグラフのデータ系列のプロパティで、値のラベルを表示することができます。もちろん、JFreeChartでも、同じように値のラベルを表示できます。

BarSampleValue

5.3　別の目盛りを追加する
棒グラフに表示した値を見ると、売上高と経常利益では10倍くらいの値の差があります。10倍くらいではまだマシなほうですが、2001年度の経常利益がいくらなのか、これではわかりません。
そこで、縦軸にもうひとつ目盛りを追加し、値の範囲が大幅に異なる場合でも識別できるようにします。

BarSampleDualAxis

簡単かと思ったら、BarSampleDualAxisのソースを見るとわかりますが、データを２つに分け、ダミーデータ（ダミー１、ダミー２）を登録し、ダミーデータの凡例を表示しないようにしたりと、意外に面倒です。
どんなライブラリを使うにしても、そのライブラリ固有のテクニック（技術力という意味ではなく、思い通りのことをするために必要な小細工）が必要になったりしますが、これはその類ですね。

5.4　タイトルのフォントを変更する
JFreeChartが適当にレイアウト、文字の大きさを設定してくれるため、多くの場合デフォルトのままでも問題ないと思いますが、propertiesファイルやユーザの自由にフォントを変更できるようにしたアプリケーションの場合、思い通りにフォントを設定したくなるときがあります。
サンプルプログラム BarSampleChangeFont では、チャートのタイトル、凡例、縦横の軸のタイトル、軸の値のラベルのフォントを変えてみました。

BarSampleChangeFont

java.awt.Font オブジェクトのコンストラクタに指定するフォント名は、動作する環境によりもっといろいろ指定できると思いますが、最低限ということで、SanSerif、Serifのみのバリエーションのみとしています。
（フォントとか、描画系の機能に弱いだけですが）

5.5　まとめると
最後に、5.1～5.4までに行ったさまざまな設定をまとめて実行してみます。
この中には、凡例を残したままサブタイトルを追加する方法も含めました。

BarSampleDemo

棒グラフのサンプルを使って、いくつか見栄えを変更するサンプルを作りました。サンプルのソースファイルに中にも書きましたが、Plot、Legend、Datasetなど、そろそろJFreeChartが表示するチャート、各部分の呼び名などを説明しないと、意味がわかりにくくなってきたと思います。

次回は、今後JFreeChartを使い込む、拡張するために必要なJFreeChartを構成するオブジェクトの名前を説明します。
ただ、私もJFreeChartの正式な教育を受けたわけでもはなく（そのようなものがあるかは知りませんが）、英語や英語圏での一般的な呼び名などをよくわかっていないため、誤った説明になる部分があるかもしれませんが、その点ご容赦ください。

NEWS（CHANGELOG.txtは2005/9/22から更新されていないので）を見ると、今回のリリースでは次のような改修が施されているようです。

• いくつかの新しいInternalXYDatasetの実装
• パフォーマンスと正確性を向上させる期間（time periodはなんて訳せばいいのだろう？）クラスの重要なリファクタリング
• データセット項目の再順序をサポートする円プロット（PiePlot）クラスへの変更
• マーカーを更新する新しいイベントメカニズム

その他の拡張やバグ修正も行われていますが、詳しくは、jfreechart-1.0.3のCHANGELOG.txtではなく、NEWSファイルを参照してください。

また、jfreechart-1.0.3をダウンロードし、ファイルを展開すると1.0.2の頃にはなかったディレクトリが追加されています。このうち、experimentalディレクトリには、新しいダイアルプロットの実装が含まれています。ディレクトリ名のとおり、実験的な実装のようなです。1.0.2には含まれていなかったソースファイルもついてます。

Dial Demo1

Dial Demo2

ちなみに、同梱されるライブラリも次のように更新されています。

今後は、JFreeChart 1.0.3を使って書いていきますが、たぶん取り上げる内容は、1.0.2、1.0.3どちらで実行しても同じ結果になると思います。（違いが出るほど深くはできないと思いますので）

シンプルなだけに逆に実際には使わないかも知れませんが、JFreeChartを設定方法、説明を理解するのに好都合です。

4.1　棒グラフの作成（その１）
　　ここでは年度ごとの売上高を棒グラフで表示する簡単なグラフを作ってみます。

public class BarSample1 {
public static void main(String[] args) {

　　ここまではどのプログラムでも同じです。

// データセットの作成
DefaultCategoryDataset dataset = new DefaultCategoryDataset();

　　別のところで書こうと思いますが、JFreeChartでは、グラフに描画するデータをDatasetというクラスに入れて管理します。
　　ちなみに、日本では一般的にグラフといいますが、英語だとチャートと呼ぶので、単にグラフを示すときは今後チャートと記します。（棒グラフ、円グラフなどグラフの種類のことをいう場合には、棒チャートとは普通言わないので棒グラフのままにしますが、コンピュータサイエンスでグラフといえば、ノードとノードを結ぶ線の集まりになってしまうので）

　　さて本題ですが、例えば、売上高が次の表の数値であったとします。

　　データセットには次のようにセットします。

// 売上高を設定
dataset.addValue(0.2, "売上高", "2001年");
dataset.addValue(2.2, "売上高", "2002年");
dataset.addValue(5.1, "売上高", "2003年");
dataset.addValue(9.8, "売上高", "2004年");
dataset.addValue(12.0, "売上高", "2005年");

　　dataset.addValue()の引数は、左から”棒グラフに表示する数値”、”値の種類”、”普通のXY座標であれば、X軸方向のメモリの単位”、の順に指定します。

　　”棒グラフに表示する数値”は、チャートに表示する棒グラフの長さを決める数値です。チャートの向きを回転させない限りXY座標では縦軸になります。
　　”値の種類”というとちょっとわかりにくいですね。今回は売上高という1種類の数値のみを棒グラフで表示しますが、売上高だけでなく利益も表示したり、販売管理費を表示するといったとき、売上高、利益、販売管理費といった”値の種類”を指定します。JFreeChart用語？では、rowKeyと呼んでいます。
　　”普通のXY座標であれば、X軸方向のメモリの単位”はチャートの向きを回転させない限りXY座標では横軸になり、JFreeChart用語？では、columnKeyと呼んでいます。私の感覚からするとrowとcolumnが逆に見えてしっくりこないのですが、たぶん私の感覚のほうがおかしいのでしょう。

　　　addValue(Number value, Comparable rowKey, Comparable columnKey);

　　つまり、rowKeyに同じ値を設定しておけば、同じ種類の値とみなされます。

　　続いて、チャートオブジェクトを作成します。JFreeChartでは、ChartFactoryクラスを使い、チャートオブジェクトのインスタンスを生成します。ChartFactoryでは、どのような種類のチャートを作成するかにより、呼び出すメソッドが変わります。
　　下の例では、棒グラフを作成するので、createBarChart()を呼び出しています。

// 棒グラフのJFreeChartオブジェクトを生成
JFreeChart chart = ChartFactory.createBarChart(
"売上高",                // チャートのタイトル
"年度",                  // X 軸のタイトル
"億円",                  // Y 軸のタイトル
dataset,                 // 各系列のデータ
PlotOrientation.VERTICAL,// 縦置き（X 軸を横、Y 軸を縦に設定）
true,                   // 凡例を描画
false,                  // Tool Tips を表示しない
false                   // URLは生成しない
);

　　各引数の意味は、上記コードのコメントのとおりです。

　　ChartFactoryクラスには、3D棒グラフ-createBarChart3D()（YXZという意味でなく単に立体的なグラフという意味での3Dです）、折れ線グラフ-createLineChart()、円グラフ-createPieChart()、さらにガントチャート-createGanttChart()などもあります。

　　そして、チャートオブジェクトを画像ファイルに書き出します。ファイルへの保存は、JFreeChartに用意されているユーティリティクラスを使えば簡単で、次のようになります。

// 画像ファイルへ出力
File outputFile = new File("bar_sample1.jpg");
try {
ChartUtilities.saveChartAsJPEG(outputFile, chart, 400, 400);
} catch (IOException ex) {
System.out.println(ex.getMessage());
}

　　400×400ピクセルのサイズを持ったJPEG形式の画像ファイルに保存します。
　　最後のメソッドとクラスの定義を閉じます。

}
}

BarSample1を実行した結果はこのようになります。

以上です。チャートを作成するために必要なのはこれだけで、あとは凡例の表示制御や各種ラベルのフォント、棒グラフの棒の色など、必要に応じて細かい設定を行えば、希望どおりのチャートを作成できます。
参考までに BarSample1のソースファイルへのリンクを張っておきます。

4.2　棒グラフの作成（その２）
　　4.1　棒グラフの作成（その１）では、１種類の値の棒グラフを作成しましたが、次は2種類の値を表示するチャートを作成します。
　　4.1　棒グラフの作成（その１）が売上高でしたので、これに経常利益の表示を追加してみます。元の値は次の表のとおりです。

　　4.1　棒グラフの作成（その１）で作成したソースファイルに対する変更箇所はデータセットに売上高の値を設定した後、次のように経常利益の値を設定するだけです。

// 経常利益を設定
dataset.addValue(0.002, "経常利益", "2001年");
dataset.addValue(0.2, "経常利益", "2002年");
dataset.addValue(0.4, "経常利益", "2003年");
dataset.addValue(0.8, "経常利益", "2004年");
dataset.addValue(1.1, "経常利益", "2005年");

　　経常利益を追加したものをBarSample2クラスとして定義します。
BarSample2を実行した結果はこのようになります。

次は、別の種類のチャートを作成し、データセット以外に系列（Series）やプロット（Plot）など、JFreeChartの構成要素を説明するか、今回作った棒グラフを使って、タイトル、サブタイトル、値のレンジが異なる軸の表示など、JFreeChartで作成するチャートに共通して使える操作の例を示すか、いづれかにしようと思います。

最初の予定とズレてきてますが…

まだ、JDKをインストールしていなければ、JDK 1.3以降をインストールして置いてください。
特に理由がなければ、最新版（2006年11月2日時点で）のJDK 5.0 Update9をインストールすればいいでしょう。

3.1 JFreeChartのダウンロード
　JFreeChartのJFreeChart Downloadからダウンロードします。実際には、SourceForge.netからのダウンロードになります。
　

　　
1. JFreeChart　1.0.2

　　

2. Documentation 　1.0.2

　　

3. JCommon　　1.0.6

　

　これら3つのファイルがダウンロードできますが、JCommonはJFreeChartが提供するJFreeReportと共通のライブラリを定義したものでJFreeChartだけを使うのであれば、単独でダウンロードしなくてもJFreeChart1.0.2の中に含まれています。
　”Download”を選択し、zipか、tarかファイルを選び、ダウンロードサイトを選択すると（しなくてもしばらくたつと）選択したファイルのダウンロードが始まります。

　JFreeChart　1.0.2に加え、JFreeChartのAPIドキュメントであるDocumentation　1.0.2もダウンロードしておくといいと思います。（たしか、以前はJFreeChartのダウンロードファイルに含まれていましたが、オンラインでも見れるので、不要な人は余計なものをダウンロードしなくて済みますね。

3.2 JFreeChartのインストール
　さて、インストールといっても使いたいのはjarのライブラリなので、ダウンロードしたzip、またはtar.gzファイルを適当なディレクトリへ展開するだけで終わりです。

　以降の説明では、JFreeChartをインストールしたディレクトリを　%JFREECHART_PATH%　として表現します。

3.3 JFreeChartのデモ
　2.JFreeChartのデモでは、Java Web Startを使ってすぐに試せるデモを実行してみましたが、今度はJFreeChartをインストールしたので、自分のPCでデモを実行してみます。
　ここでは、OSにWindowsを使った例を示します。
　コマンドプロンプトを開き、カレントディレクトリを%JFREECHART_PATH%に変更します。
　そこで
　%JFREECHART_PATH% > java -jar jfreechart-1.0.2-demo.jar
　と実行すると、2.JFreeChartのデモと同じようにSwingを使ったJFreeChartのデモプログラムが表示されます。できることはJava Web Startを使って実行したデモと全く同じですが、外出先などネットにつなげない環境でも実行できます。

　デモは豊富な例を見ることができるので、JFreeChartでどんなグラフが作れるのか見るのに最適です。
　
次は、JFreeChartを使ってグラフを作ってみます。

2.1 Java Web Startを使ってデモを実行

　Javaには、必要なときにネット上からソフトをダウンロードして、常に最新版のソフトが実行されるようにする仕組み Java Web Start があります。 Java Web Startは、Java 2 SDK, Standard Edition v1.4以降であれば、JDKに含まれており、JDKさえインストールしておけば、いつでも利用できます。

Java SE ダウンロード

JDKのインストール後、Java Web Startを使ったJFreeChartのデモは、JFreeChartのトップページにある”JFreeChart Demo (web start)”というリンクをクリックすると、直ちにダウンロードが始まり、そのままデモの実行に移り、JFreeChartが提供する様々なグラフを見ることができます。

2.2 JFreeChartをインストールして、デモをデモを実行

　これは次の「3.JFreeChartインストールとデモ」説明します。

さて、おそくらJFreeChartに興味を持った人は、既にYahoo!やGoogleで検索しているので、日本語の情報もそれなりに得ていると思いますが、ざっとここにまとめておこうと思います。

ネット上にある日本語のJFreeChart情報

ファイヤープロジェクト-JFreeChart（2004/02/07～2005/05/22）
　サンプルコードが豊富です。

@IT-サーブレットでグラフを描く（JFreeChart活用）（ 2004/10/19）
　コンパクトにまとまった記事で、JFreeChartがどのようなものかの雰囲気をつかむのにいいです。

ThinkIt-第５回：JFreeChartでグラフ作成（前編）（2005/4/1）
　2回に分け、JFreeChartでできること、使い方を詳しく解説しています。

JFreeChart、JamVMやGNU Classpath、Cairoなど、OSSのみで動作（2005/12/13）
　いくつかの環境での動作検証結果がまとめられています。

主だったところはこのようなところです。
ただ、最後のMYCOMの記事は2005年末に書かれ、1.0.0をベースにした記事なので比較的新しい部類に入りますが、それ以外は2004年や2005年に書かれたものです。細かい点で 1.0.2 と違うところあるかもしれません。もっとも、基本的な部分はあまり変わっていないため、たぶんなさそうです。

ちなみに、デモを実行するとSource Codeというタブがあり、デモのソースが見れるのかと思って期待すると、JFreeChart Developer Guide（有償）の説明だったりする。

JFreeChart Developer Guideは、US$39.95で、以降１年間は無償で更新版の提供が受けられる。（自分でダウンロードしにいく必要があったかも知れない）
１部購入したが、JDBCを使ったデータの取得、PDF、SVGへの出力についての記載はあるものの、たまたま私のプロジェクトで必要とする情報はあまり載っていなかったので、ちょっとイマイチ。ただ、デモのソースコードも同梱されているので、業務で使用する場合は妙なところで引っかかり、時間を消費するより、買ってしまったほうが早いかもしれない。

http://www.object-refinery.com/jfreechart/guide.html

また、サーバサイド、クライアントサイド、どちらでも使用することができます。
これだけだと、なんだかわからないので、ざっと列挙すると

JFreeChartが描画可能なグラフの種類

1. 円グラフ（Pie Chart）
2. 棒グラフ（Bar Chart）
3. 折れ線グラフ（Line Chart）
4. XYプロット（XY Plot）
5. 時系列グラフ（Time Series Chart）
6. ヒストグラム
7. 面グラフ（Area Chart）
8. 偏差グラフ（Difference Chart）
9. ステップチャート
10. ガントチャート

ざっとしたところは、JFreeChartのsamplesページで見ることができます。

JFreeChartが入力とすることが可能な（はずな）データソース

1. XMLファイル
2. JDBCを利用してデータベースから
3. CSVファイル
4. その他プログラムを作成すれば、任意のデータソースから

（注）以前使ったときは、カスタム形式のファイルからグラフの描画に必用なデータを読み、1プロット、あるいは１データずつグラフを描画したため、これらのファイル、接続からの利用は試してません。

JFreeChartが出力可能な形式

1. PNG
2. JPEG
3. PDF
4. EPS
5. SVG

（注）PNG、JPEG形式のファイルは作ったことがありますが、JFreeChartによれば、PDF、EPS、SVG形式も作成できるようなので、時間があればそのあたりもやってみます。

JFreeChartの動作環境

JFreeChart 1.0.2は、JDK 1.3以上を必用とし、Java 2D APIを使用します。

これから利用する場合はもちろん、この動作要件はいまではほとんど満たせると思います。

私が使っていたバージョンは、jfreechart-1.0.0-pre2 で、少々バグがあったりもしましたが、使ったアプリケーションの範囲内では何とか回避可能で、他に妥当なライブラリもなかったため、そのまま使っています。

だいたい次のような内容を予定しています。

　1.JFreeChartの概要（2006/10/30）
　2.JFreeChartのデモ（2006/10/31）
　3.JFreeChartインストールとデモ（2006/11/02）
　4.初めてのグラフ作成（2006/11/08）
　5.いろいろな出力方法
　6.グラフの調整いろいろ
　7.グラフのカスタマイズ

A1.JFreeChart 1.0.3 リリース（2006/11/25)

あとはまだあまり考えていませんが、できれば新しい種類のグラフの追加などにも触れられればと思います。

なお、使用するバージョンは2006年10月時点で最も新しい 1.0.2を使用します。

もし、記載内容に誤りや誤解を招く表現がありましたら、コメントしていただけると幸いです。
また、間違いの指摘は大歓迎です。