Main Content

histc

ヒストグラムのビンのカウント数 (推奨されません。histcountsを使用してください)

ページ内をすべて折りたたむ

histcは推奨されません。代わりにhistcountsを使用してください。

コードの更新に関する提案も含め、詳細は推奨されない hist および histc インスタンスの置き換えを参照してください。

構文

bincounts = histc(x,binranges)
bincounts = histc(x,binranges,dim)
[bincounts,ind]= histc(___)

説明

例

bincounts= histc(x,binranges)は、指定された各ビン範囲内にあるxの値の数をカウントします。入力binrangesは、各ビンの端点を決定します。出力bincountsには、各ビンのxの要素の数が含まれます。

  • xがベクトルの場合、histcはヒストグラムのビンのカウント数のベクトルとしてbincountsを返します。

  • xが行列の場合、histcは、xの各列に対して動作し、各列のヒストグラムのビンのカウント数の行列としてbincountsを返します。

ヒストグラムをプロットするには、bar(binranges,bincounts,'histc')を使用します。

bincounts= histc(x,binranges,dim)は、次元dimに沿って処理します。

例

[bincounts,ind]= histc(___)は、xの各要素が並べ替えられるビン番号を示す、xと同じサイズの配列indを返します。この構文は、前記のすべての入力引数の組み合わせで使用できます。

例

すべて折りたたむ

ライブ スクリプトを開く

乱数発生器を初期化してrandnの出力を反復可能にします。

rng(0,'twister')

xを 100 個の正規分布乱数として定義します。-4 ～ 4 のビン範囲を定義します。指定された各ビンの範囲内にあるxの値の数を決定します。各ビンの要素数をbincountsに返します。

x = randn(100,1); binranges = -4:4; [bincounts] = histc(x,binranges)
bincounts =9×10 2 17 28 32 16 3 2 0

ヒストグラムをプロットするには、bar関数を使用します。

figure bar(binranges,bincounts,'histc')

Figure contains an axes object. The axes object contains an object of type patch.

ライブ スクリプトを開く

agesを年齢のベクトルとして定義します。0 ～ 75 のさまざまな範囲をもつビンにagesを並べ替えます。

ages = [3,12,24,15,5,74,23,54,31,23,64,75]; binranges = [0,10,25,50,75]; [bincounts,ind] = histc(ages,binranges)
bincounts =1×52 5 1 3 1
ind =1×121 2 2 2 1 4 2 4 3 2 4 5

bincountsには、各ビンの値の数が含まれます。indはビン番号を示します。

入力引数

すべて折りたたむ

並べ替える値。ベクトルまたは行列として指定します。ビンのカウント数には、NaNであるか、指定されたビン範囲の外にあるxの値は含まれません。xに複素数値が含まれている場合、histcは虚数部を無視し、実数部のみを使用します。

データ型:single|double|int8|int16|int32|uint8|uint16|uint32

ビン範囲。連続する各列を下行する単調非減少の値のベクトルまたは行列で指定します。binrangesの値は、各ビンの左の端点と右の端点を決定します。binrangesに複素数値が含まれている場合、histcは虚数部を無視し、実数部のみを使用します。

binrangesが行列の場合、histcは連続する列を下行する値を使用してビン範囲を決定します。各ビンには左の端点が含まれますが、右の端点は含まれません。最後のビンは、binrangesの最後の値に等しいスカラー値で構成されます。

たとえば、binrangesがベクトル[0,5,10,13]に等しい場合、histcは 4 つのビンを作成します。最初のビンには、0 以上で 5 より厳密に小さい値が含まれます。2 つ目のビンには、5 以上で 10 より小さい値が含まれます。3 つ目のビンもこれと同様です。最後のビンには、スカラー値 13 が含まれます。

データ型:single|double|int8|int16|int32|uint8|uint16|uint32

動作する対象の次元。スカラーとして指定します。

出力引数

すべて折りたたむ

各ビンの要素の数。ベクトルまたは行列として返されます。bincountsの最後のエントリは、binrangesの最後のエントリに等しいxの値の数です。

ビンのインデックス番号。xと同じサイズのベクトルまたは行列として返されます。

ヒント

  • xの値が指定されたビン範囲の外にある場合、histcはこれらの値をビンのカウント数に含めません。xのすべての値がビンのカウント数に含まれるように、binrangesベクトルの最初の値を-infに、最後の値をinfに設定してください。

拡張機能

バージョン履歴

R2006a より前に導入

参考

||||