Main Content

imhist

イメージ データのヒストグラム

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

構文

[counts,binLocations] = imhist(I)
[counts,binLocations] = imhist(I,n)
[counts,binLocations] = imhist(X,cmap)
imhist(___)

説明

[计数,binLocations] = imhist(I)はグレースケール イメージIについてヒストグラムを計算します。関数imhistは、计数にヒストグラムのカウントを、binLocationsにビンの位置を返します。ヒストグラムの中のビン数は、イメージ タイプによって決まります。

[计数,binLocations] = imhist(I,n)は、ヒストグラムを計算するために使用されるビンの個数nを指定します。

[计数,binLocations] = imhist(X,cmap)はカラーマップcmapを使用してインデックス付きイメージXについてヒストグラムを計算します。ヒストグラムは、カラーマップの中の各エントリを 1 つのビンとします。

例

imhist(___)はヒストグラムのプロットを表示します。入力イメージがインデックス付きイメージの場合、ヒストグラムは、カラーマップcmapのカラー バー上でのピクセル値の分布を示します。

例

すべて折りたたむ

ライブ スクリプトを開く

グレースケール イメージをワークスペースに読み取ります。

I = imread('pout.tif');

イメージのヒストグラムを表示します。Iはグレースケールのため、既定の設定では、ヒストグラムのビンは 256 個になります。

imhist(I)

Figure contains 2 axes objects. Axes object 1 contains an object of type stem. Axes object 2 contains 2 objects of type image, line.

ライブ スクリプトを開く

3 次元データセットを読み込みます。

loadmristack

データのヒストグラムを表示します。このイメージはグレースケールのため、imhistは既定の設定で 256 個のビンを使用します。

imhist(mristack)

Figure contains 2 axes objects. Axes object 1 contains an object of type stem. Axes object 2 contains 2 objects of type image, line.

入力引数

すべて折りたたむ

グレースケール イメージ。任意の次元の数値配列として指定します。イメージのデータ型がsingleまたはdoubleの場合、値は [0, 1] の範囲でなければなりません。Iが [0, 1] の範囲外の値を持つ場合、関数rescaleを使用して、想定される範囲に値を再スケーリングできます。

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

ビンの数。正の整数として指定します。Iがグレースケール イメージの場合、imhistは既定値として 256 個のビンを使用します。Iがバイナリ イメージの場合、imhistは 2 つのビンを使用します。

例:50

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

インデックス付きイメージ。任意の次元の数値配列として指定します。

データ型:single|double|uint8|uint16|logical

インデックス付きイメージXに関連付けられたカラーマップ。範囲 [0, 1] の値をもつc 行 3 列の数値行列として指定します。各行は、カラーマップの単一色を構成する赤、緑、青の成分を指定する 3 要素の RGB 3 成分です。カラーマップは、少なくともXの中の最大インデックスと同じ長さでなければなりません。

データ型:double

出力引数

すべて折りたたむ

ヒストグラムのカウント。数値配列として返されます。インデックス付きイメージXについてヒストグラムを計算する場合、计数の長さは、カラーマップcmapの長さと同じになります。

ビンの位置。数値配列として返されます。

ヒント

  • グレースケール イメージについて、ヒストグラムのn個のビンは、それぞれ幅A/(n−1)の半開区間になります。特に、pth番目のビンの半開区間は、次のようになります。

    A ( p − 1.5 ) ( n − 1 ) − B ≤ x < A ( p − 0.5 ) ( n − 1 ) − B ,

    ここで、xは強度値です。倍率 A とオフセット B は、以下のようにイメージ クラスの型によって異なります。

    データ型 A B
    double 1 0
    single 1 0
    int8 255 128
    int16 65,535 32,768
    int32 4,294,967,295 2,147,483,648
    uint8 255 0
    uint16 65,535 0
    uint32 4,294,967,295 0
    logical 1 0

  • ヒストグラムを计数とbinLocationsから表示するには、stem(binLocations,counts)コマンドを使用します。

拡張機能

バージョン履歴

R2006a より前に導入

参考

||