imhist

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

構文

[counts,binLocations] = imhist(I)

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

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

imhist(___)

説明

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

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

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

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

例

ヒストグラムの計算

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

I = imread('pout.tif');

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

imhist(I)

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

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

load mristack

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

imhist(mristack)

入力引数

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

数値配列

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

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

n — ビンの数

正の整数

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

例: 50

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

数値配列

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

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

cmap — カラーマップ

c 行 3 列の数値行列

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

データ型: double

出力引数

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

数値配列

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

binLocations — ビンの位置

数値配列

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

ヒント

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

  $$\frac{A(p-1.5)}{(n-1)}-B\le x<\frac{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

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

拡張機能

C/C++ コード生成

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

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

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

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

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

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

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

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

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

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数は、スレッドベースの環境を完全にサポートします。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

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

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

• GPU 上では imhist はインデックス付きイメージをサポートしません。

• GPU 上で出力引数を省略した場合、imhist はヒストグラムを表示しません。この場合、関数はヒストグラム カウントを変数 ans に返し、ヒストグラムのビンの位置は返しません。

詳細については、GPU でのイメージ処理を参照してください。

バージョン履歴

R2006a より前に導入

R2022b: スレッドベース環境のサポート

imhist は、スレッドベースの環境をサポートするようになりました。

参考

histeq | histogram | stem