目次 前へ 次へ

5.2 基本マトリックス・グラフの作成とフォーマット

マトリックス・プロットのを作成するときは、拡張モジュール「jpgraph_matrix.php」をコア・モジュールである「jpgraph.php」と共にスクリプトに含める必要があります。

それ以外はマトリックス・グラフの作成は、１つ以上のマトリックス・プロットのキャンバスとなるマトリックス・グラフ・エリアを作成するときの、ライブラリの通常の手順に従います。原則的な手順は次の通りです。

  1. MatrixGraphクラスのインスタントとして基本マトリックス・グラフ・エリアを作成する。（JpGraphのすべての例で、このインスタンスを使う場合、$graph変数を使用しています。）
  2. P align="left" class="style1">2. １つ以上のマトリックス・プロットをMatrixPlotクラスのインスタンスとして作成し、カラー・マップや体裁に必要な変更を加え、マトリックス・グラフ・キャンバスに追加する。
  3. MatrixGraph::Stroke()メソッドで、グラフをブラウザに送る。他のグラフ同様、このメソッドは、ブラウザ（クライアント）に返すことも、ファイル名を第1引数として指定してファイルにグラフを書き込むことも可能。

図5.2はすべてのパラメタに初期設定値を使用したマトリックス・プロットを表示したものです。

(File:matrix_ex0.php)
<?php // content="text/plain; charset=utf-8"
require_once('jpgraph/jpgraph.php');
require_once('jpgraph/jpgraph_matrix.php');
 
// ランダムなマトリックス
$data = array(
    array(0,1,2,3,4,5,6,7,8,9,10),
    array(10,9,8,7,6,5,4,3,2,1,0),
    array(0,1,2,3,4,5,6,7,8,9,10),
    array(10,9,8,17,6,5,4,3,2,1,0),
    array(0,1,2,3,4,4,9,7,8,9,10),
    array(8,1,2,3,4,8,3,7,8,9,10),
    array(10,3,5,7,6,5,4,3,12,1,0),
    array(10,9,8,7,6,5,4,3,2,1,0),
);
 
// 基本マトリックスグラフ・エリアを作成し、タイトルを設定。
$graph = new MatrixGraph(400,300);
$graph->title->Set('Basic matrix example');
$graph->title->SetFont(FF_ARIAL,FS_BOLD,14);
 
// 初期設定値のみを使用したマトリックス・プロットを作成。
$mp = new MatrixPlot($data);
$graph->Add($mp);
 
$graph->Stroke();
 
?>


図5.2 初期設定値の基本マトリックス・グラフ[ソース]

 

他のタイプのグラフ同様、マトリックス・プロットも単一でも複数でも同じマトリックス・グラフ・エリアに自由に配置できます。位置設定は座標の絶対値でも、グラフ・エリアの幅・高さに対する比率でもどちらでも指定ができます。

Tips:
マトリックス・プロットを簡単に位置設定するにはレイアウト・クラスを使います。

Tips:
マトリックスのデータがファイルに存在するなら、ユーティリティクラスのReadFileDataを使い、次のメソッドでファイル内のデータを取り込むのが便利でしょう。

これは、ファイルからマトリックスを読み込みます。マトリックスの各行は個別のラインで、各セルは第2引数として指定された文字で区別されます。初期設定によりスペースはセパレータとして認識されます。読み返される値はすべて浮動小数点（倍精度）に変換されます。次の例はこの手法の使い方が非常に簡単であることを示しています。

$data = ReadFileData::FromMatrix('matrixdata.txt');

タイトルやフッタの追加などのグラフ・フォーマットの標準オプションについては、他のグラフと同じですので他の章をご参照ください。

目次 前へ 次へ