imadjust

イメージの強度値またはカラーマップの調整

構文

J = imadjust(I)

J = imadjust(I,[low_in high_in])

J = imadjust(I,[low_in high_in],[low_out high_out])

J = imadjust(I,[low_in high_in],[low_out high_out],gamma)

J = imadjust(RGB,[low_in high_in],___)

newcmap = imadjust(cmap,[low_in high_in],___)

説明

J = imadjust(I) はグレースケール イメージ I の強度の値を J の新しい値にマッピングします。この構文を使用すると、imadjust はすべてのピクセル値の下位 1% と上位 1% を飽和させます。この関数は、彩度の上下限の間にあるピクセル値を 0 ～ 1 の値に線形にマッピングします。この操作により、出力イメージ J のコントラストが増大します。

この構文は、imadjust(I,stretchlim(I)) と等価です。

J = imadjust(I,[low_in high_in]) は、low_in と high_in の間の値が 0 と 1 の間の値に線形にマッピングされるように、I の強度の値を J の新しい値にマッピングします。

J = imadjust(I,[low_in high_in],[low_out high_out]) は、low_in と high_in の間の値が low_out と high_out の間の値に線形にマッピングされるように、I の強度の値を J の新しい値にマッピングします。

J = imadjust(I,[low_in high_in],[low_out high_out],gamma) は I の強度の値を J の新しい値にマッピングします。ここで、gamma は、I の値と J の値の関係を記述する曲線の形状を指定します。

J = imadjust(RGB,[low_in high_in],___) はトゥルーカラー イメージ RGB の値を J の新しい値にマッピングします。各カラー チャネルに同じマッピングまたは固有のマッピングを適用できます。

newcmap = imadjust(cmap,[low_in high_in],___) はカラーマップ cmap の値を newcmap の新しい値にマッピングします。各カラー チャネルに同じマッピングまたは固有のマッピングを適用できます。

例

グレースケール イメージのコントラスト調整

低コントラストのグレースケール イメージをワークスペースに読み取って表示します。

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

イメージのコントラストを調整してデータが高強度と低強度で 1 % 飽和するようにし、それを表示します。

J = imadjust(I);
figure
imshow(J)

コントラストの範囲指定によるグレースケール イメージのコントラスト調整

低コントラストのグレースケール イメージをワークスペースに読み取って表示します。

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

コントラストの範囲を指定して、イメージのコントラストを調整します。

K = imadjust(I,[0.3 0.7],[]);
figure
imshow(K)

カラー イメージのコントラスト調整

RGB イメージをワークスペースに読み取って表示します。

RGB = imread('football.jpg');
imshow(RGB)

コントラストの範囲を指定して、RGB イメージのコントラストを調整します。

RGB2 = imadjust(RGB,[.2 .3 0; .6 .7 1],[]);
figure
imshow(RGB2)

標準偏差に基づくイメージ ストレッチ

イメージをワークスペースに読み取って表示します。

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

ストレッチを行うために、標準偏差とイメージの平均値を計算します。

n = 2;  
Idouble = im2double(I); 
avg = mean2(Idouble);
sigma = std2(Idouble);

標準偏差に基づいてコントラストを調整します。

J = imadjust(I,[avg-n*sigma avg+n*sigma],[]);

調整されたイメージを表示します。

imshow(J)

入力引数

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

m 行 n 列の数値行列

グレースケール イメージ。m 行 n 列の数値行列として指定します。I が整数データ型の場合、imadjust はまず im2double を使用してピクセル値を [0, 1] の範囲に再スケーリングします。入力コントラスト範囲と出力コントラスト範囲の間で値をマッピングしてコントラストを調整した後、関数は出力イメージを元の I のデータ型に変換し直します。

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

RGB — トゥルーカラー イメージ

m x n x 3 の数値配列

トゥルーカラー イメージ。m x n x 3 の数値配列として指定します。RGB が整数データ型の場合、imadjust はまず im2double を使用してピクセル値を [0, 1] の範囲に再スケーリングします。入力コントラスト範囲と出力コントラスト範囲の間で値をマッピングしてコントラストを調整した後、関数は出力イメージを元の RGB のデータ型に変換し直します。

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

cmap — カラーマップ

c 行 3 列の数値行列

カラーマップ。範囲 [0, 1] の値をもつ c 行 3 列の数値行列として指定します。各行は、カラーマップの単一色を構成する赤、緑、青の成分を指定する 3 要素の RGB 3 成分です。

データ型: double

[low_in high_in] — 入力イメージのコントラストの範囲

2 要素の数値ベクトル | 2 行 3 列の数値行列

入力イメージのコントラストの範囲。次の表のいずれかの値として指定します。

入力タイプ	値	説明
グレースケール イメージ	[low_in high_in] 形式の 1 行 2 列ベクトル	出力イメージの値にマッピングする入力グレースケール イメージのコントラストの範囲を指定します。値は [0 1.0] の範囲でなければなりません。値 low_in が値 high_in 未満でなければなりません。
グレースケール イメージ	指定なし	構文 imadjust(I) を使用して入力引数を 1 つだけ指定した場合、関数は入力イメージの値に基づいて low_in と high_in を設定し、すべてのピクセル値の下位 1% と上位 1% を飽和させます。
RGB イメージまたはカラーマップ	[low_RGB_triplet; high_RGB_triplet] 形式の 2 行 3 列の行列	出力イメージまたはカラーマップの値にマッピングする入力 RGB イメージまたはカラーマップのコントラストの範囲を指定します。配列の各行は RGB カラーの 3 成分です。値は [0 1] の範囲でなければなりません。値 low_RGB_triplet が値 high_RGB_triplet 未満でなければなりません。
RGB イメージまたはカラーマップ	[low_in high_in] 形式の 1 行 2 列ベクトル	出力イメージの値にマッピングする入力 RGB イメージのコントラストの範囲を指定します。各値は [0 1.0] の範囲になければなりません。値 low_in が値 high_in 未満でなければなりません。RGB イメージまたはカラーマップで 1 行 2 列のベクトルを指定する場合、imadjust は色平面またはチャネルごとに同じ調整を適用します。
すべてのタイプ	[]	空行列 ([]) を指定した場合、imadjust は範囲 [0 1] を使用します。

imadjust 関数は、low_in より小さい値と high_in より大きい値を切り取ります。low_in より小さい値は low_out にマッピングし、high_in より大きい値は high_out にマッピングします。

データ型: single | double

[low_out high_out] — 出力イメージのコントラストの範囲

[0 1] (既定値) | 2 要素の数値ベクトル | 2 行 3 列の数値行列

出力イメージのコントラストの範囲。次の表のいずれかの値として指定します。

入力タイプ	値	説明
グレースケール イメージ	[low_out high_out] 形式の 1 行 2 列ベクトル	出力グレースケール イメージのコントラストの範囲を指定します。各値は [0 1] の範囲になければなりません。
RGB イメージまたはカラーマップ	[low_RGB_triplet; high_RGB_triplet] 形式の 2 行 3 列の行列	出力 RGB イメージまたはカラーマップのコントラストの範囲を指定します。配列の各行は RGB カラーの 3 成分です。値は [0 1] の範囲でなければなりません。
RGB イメージまたはカラーマップ	[low_out high_out] 形式の 1 行 2 列ベクトル	出力イメージのコントラストの範囲を指定します。各値は [0 1] の範囲になければなりません。RGB イメージまたはカラーマップで 1 行 2 列のベクトルを指定する場合、imadjust は平面またはチャネルごとに同じ調整を適用します。
すべてのタイプ	指定なし、または []	出力コントラストの範囲を指定しない場合、または空行列 ([]) を指定した場合、imadjust は既定の範囲 [0 1] を使用します。

high_out が low_out より小さい場合、imadjust は写真のネガのように出力イメージを反転します。

データ型: single | double

gamma — 入力値と出力値の関係を表す曲線の形状

1 (既定値) | 非負のスカラー | 1 行 3 列の数値ベクトル

入力値と出力値の関係を表す曲線の形状。非負のスカラーまたは 1 行 3 列の数値ベクトルとして指定します。

• gamma が 1 より小さい場合、imadjust のマッピングでは高い (明るい) 出力値の方に重みが加わります。

• gamma が 1 より大きい場合は、imadjust のマッピングでは低い (暗い) 出力値の方に重みが加わります。

• gamma が 1 行 3 列のベクトルの場合、imadjust は色成分またはチャネルごとに固有のガンマを適用します。

• 引数を省略した場合、gamma は既定の 1 (線形マッピング) に指定されます。

次のグラフィックスは、gamma が 1 未満の場合、1 に等しい場合、および 1 より大きい場合の変換曲線の形状を示しています。各グラフで、x 軸は入力イメージの強度値を表し、y 軸は出力イメージの強度値を表します。

データ型: double

出力引数

J — 調整されたイメージ

グレースケール イメージ | RGB イメージ

調整されたイメージ。グレースケール イメージまたは RGB イメージとして返されます。J のサイズとクラスは入力グレースケール イメージ I またはトゥルーカラー イメージ RGB と同じです。

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

newcmap — 調整されたカラーマップ

c 行 3 列の数値行列

調整されたカラーマップ。入力カラーマップ cmap と同じクラスの c 行 3 列の数値行列として返されます。

データ型: single | double

拡張機能

C/C++ コード生成

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

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

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

• コードを生成する際、imadjust ではインデックス付きイメージがサポートされません。

GPU コード生成

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

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

• コードを生成する際、imadjust ではインデックス付きイメージがサポートされません。

GPU 配列

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

この関数は、GPU 配列を完全にサポートします。詳細については、GPU でのイメージ処理を参照してください。

バージョン履歴

R2006a より前に導入

参考

brighten | histeq | stretchlim | lin2rgb | rgb2lin

トピック

• ガンマ補正
• コントラスト強調方法