最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

imhist

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

構文

[counts,binLocations] = imhist(I)

[counts,binLocations] = imhist(I,n)

[counts,binLocations] = imhist(X,map)

imhist(___)

説明

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

オプションで、ヒストグラムのカウントとビンの位置の計算を GPU を使用して実行できます (Parallel Computing Toolbox™ が必要)。詳細は、GPU での画像処理を参照。

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

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

GPU では、この構文はサポートされていません。

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

I が gpuArray のときにこの構文を使用すると、プロットは表示されません。imhist はヒストグラムのカウントを ans に返し、ヒストグラムのビンの位置は返しません。

例

ヒストグラムの計算

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

I = imread('pout.tif');

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

imhist(I)

3 次元強度イメージのヒストグラムの表示

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

load mristack

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

imhist(mristack)

GPU でのヒストグラムの計算

uint16 クラスの配列を作成します。

I = gpuArray(imread('pout.tif'));

ヒストグラムを計算します。imhist は、GPU で実行した場合はヒストグラムのプロットを自動的に表示しないため、この例では stem を使用してヒストグラムをプロットします。

[counts,x] = imhist(I);
stem(x,counts);

入力引数

I — グレースケール イメージ

数値配列 | gpuArray

グレースケール イメージ。任意の次元の数値配列として指定します。

GPU を使用してヒストグラムのカウントとビンの位置を計算するには、I を数値配列を含む gpuArray として指定します。

例: I = imread('cameraman.tif');

例: I = gpuArray(imread('cameraman.tif'));

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

n — ビンの数

256 (グレースケール イメージの場合) (既定値) | 数値スカラー

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

例: [counts,x] = imhist(I,50);

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

X — インデックス付きイメージ

数値配列

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

例: [X,map] = imread('trees.tif');

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

map — インデックス付きイメージと関連付けられたカラーマップ

c 列 3 行の行列

インデックス付きイメージ X と関連付けられたカラーマップ。c 行 3 列の行列として指定します。カラーマップは、少なくとも X の中の最大インデックスと同じ長さでなければなりません。

例: [X,map] = imread('trees.tif');

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

出力引数

counts — ヒストグラムのカウント

数値配列 | gpuArray

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

GPU を使用してヒストグラムを計算する場合、counts は数値配列を含む gpuArray として返されます。

binLocations — ビンの位置

数値配列 | gpuArray

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

GPU を使用してヒストグラムを計算する場合、binLocations は数値配列を含む gpuArray として返されます。

ヒント

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

  $$\frac{A(p-1.5)}{(n-1)}-B\le x<\frac{A(p-0.5)}{(n-1)}-B,$$

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

  	double	single	int8	int16	int32	uint8	uint16	uint32	logical
  A	1	1	255	65535	4294967295	255	65535	4294967295	1
  B	0	0	128	32768	2147483648	0	0	0	0

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

拡張機能

C/C++ コード生成

MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意事項および制限事項:

• この関数では MATLAB^® Coder™ を使用した C コードの生成がサポートされています。汎用の MATLAB Host Computer ターゲット プラットフォームを選択した場合、プリコンパイルされたプラットフォーム固有の共有ライブラリを使用するコードが、この関数によって生成されます。共有ライブラリを使用するとパフォーマンスの最適化は維持されますが、コードを生成できるターゲット プラットフォームが限定されます。詳細は、Image Processing Toolbox のコード生成についてを参照してください。

• 最初の入力がバイナリ イメージの場合、n はコンパイル時の値が 2 のスカラー定数でなければなりません。

• 非プログラム構文はサポートされません。たとえば、構文 imhist(I) では、imhist はヒストグラムを表示するため、この構文はサポートされていません。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

使用上の注意事項および制限事項:

• GPU で実行する場合、imhist はヒストグラムを表示しません。ヒストグラムを表示するには、stem(binLocations,counts) を使用します。

詳細は、GPU での画像処理を参照してください。

参考

histeq | histogram | stem

R2006a より前に導入