% GPLOTMATRIX 共通変数でグループ化された散布図プロット行列
%
%   GPLOTMATRIX(X,Y,G) は、G でグループ化されたY の列に対する X の列の
%   散布図プロット行列を作成します。X が P×M で、Y が P×N の場合、
%   GPLOTMATRIX は、軸の N×M の行列を作成します。G は、各行列内の各点に
%   対するマーカやカラーを設定します。Y を省略するか、[] で設定する場合、
%   関数は、X と X との関係をグラフ化します。G は、各行列内の各点に割り
%   当てられたマーカーとカラーで定義されるグループ化変数で、ベクトル、
%   または文字列の行列、文字列のセル配列です。また、G は、グループ化変数の
%   それぞれ固有の結合によって X 内の値をグループ化するために、
%   ({G1 G2 G3} のように) グループ化変数のセル配列としても構いません。
% 
%   GPLOTMATRIX(X,Y,G,CLR,SYM,SIZ) は、使用するカラー、マーカ、サイズを
%   指定します。CLR は、カラーの仕様を設定する文字列、SYM は、マーカの
%   仕様を設定する文字列です。より詳細な情報を得るには、"help plot" と
%   入力してください。たとえば、SYM = 'o+x' は、最初のグループを円 (o) 
%   マークで、2 番目のグループをプラス (+) マークで、3 番目をバツ (x) 
%   マークで、表示します。SIZ は、プロットで使用するマーカのサイズを
%   指定します。デフォルトでは、カラーは 'bgrcmyk'、マーカは '.'、マーカの
%   サイズは、Figure ウィンドウのサイズとプロット数に依存します。
% 
%   GPLOTMATRIX(X,Y,G,CLR,SYM,SIZ,DOLEG) は、凡例を作成するか否かを制御
%   します。DOLEG は、'on' (デフォルト)、または 'off' のいずれかを設定
%   します。
% 
%   GPLOTMATRIX(X,Y,G,CLR,SYM,SIZ,DOLEG,DISPOPT) は、X と Y の関係の
%   プロット図の中で、対角部の塗りつぶし法を制御します。DISPOPT を 'none' 
%   とすると空白のままになり、'hist' (デフォルト) とするとヒストグラムを
%   プロットし、'variable' の場合は変数名を記述します。
% 
%   GPLOTMATRIX(X,Y,G,CLR,SYM,SIZ,DOLEG,DISPOPT,XNAM,YNAM) は、X と Y の
%   変数名を XNAM と YNAM を使って設定します。それぞれ、適切な次元の
%   文字配列でなければなりません。
% 
%   [H,AX,BigAx] = GPLOTMATRIX(...) は、プロットした点へのハンドル H、
%   個々のサブ軸へのハンドルの行列 AX、サブ軸を囲む大きな (非可視の)
%   座標軸へのハンドル BIGAX の配列を返します。H の 3 番目の次元は、
%   G のグループに対応します。DISPOPT が 'hist' の場合、AX はヒストグラム
%   がプロットされた非可視の座標軸へのハンドルの 1 つの追加行を含みます。
%   BigAx は、後に続く TITLE, XLABEL, YLABEL のいずれかが、座標軸の行列に
%   対して中心になるように CurrentAxes のままです。
%
%   例:
%      load carsmall;
%      X = [MPG,Acceleration,Displacement,Weight,Horsepower];
%      varNames = {'MPG' 'Acceleration' 'Displacement' 'Weight' 'Horsepower'};
%      gplotmatrix(X,[],Cylinders,'bgrcm',[],[],'on','hist',varNames);
%
%   参考 GRPSTATS, GSCATTER, PLOTMATRIX.


%   Copyright 1993-2007 The MathWorks, Inc. 
