% HIST3   2変数データの3次元ヒストグラム
%
%   HIST3(X) は、M×2 行列 X の要素を等間隔の格納、10×10 グリッドに分け、
%　 ヒストグラムをプロットします。X の各列は、ビングリッドの1次元に
%   相当します。
%
%   HIST3(X,NBINS) は、NBINS(1)×NBINS(2) グリッドのビンを使用して
%   ヒストグラムをプロットします。HIST3(X,'Nbins',NBINS) は、HIST3(X,NBINS)
%   に等価です。
%
%   HIST3(X,CTRS)は、第1次元について中央が　CTRS{1}、第2次元について 中央が
%　 CTRS{2}であるようなビンの2次元グリッドを使用します。ここで、CTRS は、
%   単調に減少しない値をもつ数値ベクトルの 2 要素セル配列です。
%   HIST3 は、グリッドの範囲外になる X の行を、グリッドの外端に隣接する
%　 ビンに割り当て、NaNを含む Xの行を無視します。
%   HIST3(X,'Ctrs',CTRS) は、HIST3(X,CTRS) に等価です。
%
%   HIST3(X,'Edges',EDGES)は、第1次元について端が EDGES{1}、第2次元について
%　 端が EDGES{2} のビンの2次元グリッドを使用します。ここで、EDGES は、
%   単調に減少しない値をもつ数値ベクトルの2要素セル配列です。
%   (i,j) 番目のビンは、つぎの場合、値 X(k,:) を含みます。
%
%      EDGES{1}(i) <= X(k,1) < EDGES{1}(i+1) かつ
%      EDGES{2}(j) <= X(k,2) < EDGES{2}(j+1).
%
%   グリッドの上端になる X の行、EDGES{1}(end) または EDGES{2}(end)は、
%    (I,j)番目 または (i,J)番目のビンにカウントされます。ここで、
%   I と J は、EDGES{1} と EDGES{2} の長さです。 HIST3 は、グリッドの範囲の
%   外側になる X の行をカウントしません。
%   すべての NaN でない値を含むためには、 EDGES に -Inf と Inf を使用します。
%
%   N = HIST3(X,...) は、グリッドの各ビンに入る X の要素数を含む行列を出力し、
%   ヒストグラムをプロットしません。
%   
%   [N,C] = HIST3(X,...) は、数値ベクトルの1×2 セル配列に、 ビンの中央の位置
%   を出力し、ヒストグラムをプロットしません。
%
%   HIST3(AX,X,...) は、GCA ではなく AX にプロットします。
%
%   HIST3(..., 'PARAM1',val1, 'PARAM2',val2, ...) により、プロットを
%　 微調整するようにグラフィックスパラメータの名前/値の組を指定することが
%   できます。
%
%   例:
%
%      % 自動車データを作成し、 7x7 グリッドのビンのヒストグラムを作成します。
%      load carbig
%      X = [MPG,Weight];
%      hist3(X,[7 7]);
%      xlabel('MPG'); ylabel('Weight');
%
%      % 半透明のバーをもつヒストグラムを作成します。
%      hist3(X,[7 7],'FaceAlpha',.65);
%      xlabel('MPG'); ylabel('Weight');
%      set(gcf,'renderer','opengl');
%
%      % 各方向に異なる、ビンの中央を指定します。
%      % カウントし直しますが、プロットしません。
%      cnt = hist3(X, {0:10:50 2000:500:5000});
%
%   参考 ACCUMARRAY, BAR, BAR3, HIST, HISTC.


%   Copyright 1993-2004 The MathWorks, Inc.