% BOXPLOT   データ標本のボックスプロット
%
%   BOXPLOT(X) は、X の各列に対して1つのボックスをもつ箱ひげプロットを
%   生成します。ボックスは、下位四分位点、中央値、上位四分位点にラインが
%   あります。ヒゲは、データの残りの範囲を示すためにボックスのそれぞれの
%   端から伸びるラインです。異常値は、ヒゲの端を超えた値をもつデータです。
%
%   BOXPLOT(X,G) は、G でグループ化されたベクトル X に対する箱ヒゲプロットを
%   生成します。G は、ベクトル、文字列の行列、または文字列のセル配列で
%   定義されるグループ化変数です。G は、グループ化変数の値のそれぞれの
%   固有の結合によって X の値をグループ化するために、({G1 G2 G3} のように)
%   様々なグループ化変数のセル配列にもできます。
% 
%   BOXPLOT(...,'PARAM1',val1,'PARAM2',val2,...) は、追加のパラメータ 名前/値
%   の組み合わせを指定します:
%
%      'notch'       'on' 刻み付き (デフォルトは 'off')
%      'symbol'      すべての異常値に使われる記号 (デフォルトは 'r+')
%      'orientation' ボックスの方向。 'vertical' (デフォルト) または 'horizontal'
%      'whisker'     最大のヒゲの長さ (デフォルト 1.5)
%      'labels'      X の各列、または G の各グループのラベルを含む文字列の
%                    セル配、または文字配列
%      'colors'      ボックスの色の文字列、または 3 列の行列。各ボックス 
%                    (輪郭、中央値のライン、ヒゲ) は、対応する色で描画
%                    されます。デフォルトでは、青で輪郭、赤で中央値、
%                    黒でヒゲを使ってボックスを描画します。色は、必要に
%                    応じて再度使われます。
%      'widths'      ボックス幅の数値ベクトル、またはスカラ。デフォルトでは、
%                    0.5、または 3 つより少ないボックスに対してわずかに
%                    小さいです。幅は、必要に応じて再度使われます。
%      'grouporder'  G が与えられた場合、G のグループをプロットする必要の
%                    ある順番となるグループ名の文字配列、またはセル配列。
%                    G が与えられない場合無視されます。
%      'positions'   ボックスの位置の数値ベクトル。デフォルトは 1:n です。
% 
%   刻み付きのボックスプロットにおいて、刻みは、ボックス間を比較するために
%   中央値についての不確かさのロバストな推定を表します。刻みが重ならない
%   ボックスは、5% の有意水準で2つのグループの中央値が異なることを示します。
%   WHIS が 'whisker' パラメータの値で、IQR が標本の四分位範囲である場合、
%   ヒゲはボックスから WHIS*IQR 内の最極のデータ値に伸びます。
%
%   BOXPLOT(AX,...) は、ハンドル AX をもつ座標軸にプロットします。
%
%   H = BOXPLOT(...) は、ボックスプロットのラインへのハンドル H を出力します。
%   H はボックスの様々な部分に対するハンドルで構成されており、1 つのボックスに
%   対して 1 つの列になります。各列は、上部のヒゲと下部のヒゲ、上部に隣接
%   する値、下部に隣接する値、ボックス、中央値、異常値の 7 つのハンドルを
%   含みます。
%
%   例:  国ごとにグループ化された自動車の燃費のボックスプロット
%      load carsmall
%      boxplot(MPG, Origin)
%      boxplot(MPG, Origin, 'sym','r*', 'colors',hsv(7))
%      boxplot(MPG, Origin, 'grouporder', ...
%                   {'France' 'Germany' 'Italy' 'Japan' 'Sweden' 'USA'})
%
%   例: 燃費の中央値でプロット
%      [sortedMPG,sortedOrder] = sort(grpstats(MPG,Origin,@median));
%      pos(sortedOrder) = 1:6;
%      boxplot(MPG, Origin, 'position', pos)
%
%   参考 ANOVA1, KRUSKALWALLIS, MULTCOMPARE.


%   Copyright 1993-2007 The MathWorks, Inc.