% BIPLOT   変数/因子係数およびスコアのバイプロット
%
%   BIPLOT(COEFS)は、行列COEFS内の係数のバイプロットを作成します。バイプロット
%   は、COEFSが2列の場合は2Dで、3列の場合は3Dです。COEFSは、通常、PRINCOMPまた
%   はPCACOVによって作成される主成分係数、あるいはFACTORANによって推定される因子
%   荷重を含みます。バイプロットのaxesは、主成分または潜在因子(COEFSの列)を表わし、
%   観測される値(COEFSの行) はベクトルとして表わされます。
%
%   BIPLOT(COEFS, ..., 'Scores', SCORES) は、バイプロットの行列SCORES内のCOEFSと
%   スコアの両方をプロットします。SCORESは、通常、PRINCOMPによって作成される
%   主成分スコアあるいはFACTORANによって推定される因子を含みます。各観測値(SCORES
%   の行)は、バイプロット内の点として表わされます。
%
%   バイプロットは、最初の2または3つの主成分に対する各変数の寄与の大きさと符号を可視化
%   し、各観測がそれらの成分に関してどのように表わされるかを可視化することができます。
%   BIPLOTは、COEFSの各列で最大の大きさをもつ要素を正にして、符号の用法を設定します。
%
%   BIPLOT(COEFS, ..., 'VarLabels',VARLABS)は、キャラクタ配列またはセル配列
%   VARLABSのテキストによって、各ベクトル (変数)にラベルを付けます。
%
%   BIPLOT(COEFS, ..., 'Scores', SCORES, 'ObsLabels', OBSLABS)は、データ
%   カーソルの表示の際に、観測名としてキャラクタ配列またはセル配列OBSLABSのテ
%   キストを利用します。
%
%   BIPLOT(COEFFS, ..., 'PropertyName',PropertyValue, ...)は、BIPLOTにより
%   作成されるすべてのlineグラフィックスオブジェクトに対して指定されたプロパティ
%   値をプロパティに設定します。 
%
%   H = BIPLOT(COEFS, ...)は、BIPLOTにより作成されるグラフィックスオブジェクト
%   のハンドルからなる列ベクトルを出力します。Hは、順に、変数(lineハンドル、その
%   後にマーカのハンドル、さらにテキストのハンドル)、観測値(存在する場合は、マーカ
%   のハンドル), 軸のlinesに対応するハンドルを含みます。
%
%   例題:
%
%      load carsmall
%      X = [Acceleration Displacement Horsepower MPG Weight];
%      X = X(all(~isnan(X),2),:);
%      [coefs,score] = princomp(zscore(X));
%      vlabs = {'Accel','Disp','HP','MPG','Wgt'};
%      biplot(coefs(:,1:3), 'scores',score(:,1:3), 'varlabels',vlabs);
%
% 参考  FACTORAN, PRINCOMP, PCACOV, ROTATEFACTORS.


%   Copyright 1993-2004 The MathWorks, Inc.