label2rgb

ラベル行列を RGB イメージに変換

構文

RGB = label2rgb(L)

RGB = label2rgb(L,cmap)

RGB = label2rgb(L,cmap,zerocolor)

RGB = label2rgb(L,cmap,zerocolor,order)

RGB = label2rgb(___,'OutputFormat',outputFormat)

説明

RGB = label2rgb(L) は、ラベル イメージ L を、ラベル化された領域を可視化する目的で、RGB カラー イメージに変換します。関数 label2rgb は、ラベル行列内のオブジェクト数をベースに個々のオブジェクトに割り当てる色を決定します。関数 label2rgb は、カラーマップのすべての範囲から色をピックアップします。

RGB = label2rgb(L,cmap) は RGB イメージで使用されるカラーマップ cmap を指定します。

RGB = label2rgb(L,cmap,zerocolor) は、背景要素 (0 というラベルが付けられたピクセル) の RGB カラーを指定します。

RGB = label2rgb(L,cmap,zerocolor,order) は、label2rgb が、ラベル行列の中の領域に色をどのように割り当てるかを制御します。

RGB = label2rgb(___,'OutputFormat',outputFormat) では、この関数で RGB イメージではなく一意の色のリストを返すよう指定できます。

例

色を使用したラベル行列の要素の強調表示

イメージを読み取り、それを表示します。

I = imread('rice.png'); 
imshow(I)

イメージからラベル行列を作成します。

BW = imbinarize(I); 
CC = bwconncomp(BW);
L = labelmatrix(CC);

既定の設定を使用して、ラベル行列を RGB イメージに変換します。

RGB = label2rgb(L);
figure
imshow(RGB)

オプションのパラメーターを指定して、ラベル行列を RGB イメージに変換します。この例では 'spring' カラーマップを使用して、背景ピクセルをシアンに設定し、無作為で各ラベルに色を割り当てます。

RGB2 = label2rgb(L,'spring','c','shuffle'); 
figure
imshow(RGB2)

入力引数

L — ラベル イメージ

非負の整数の行列 | categorical 行列

連続領域のラベル イメージ。次のいずれかを指定します。

• 非負の整数の行列。0 とラベル付けされたピクセルは背景です。1 とラベル付けされたピクセルは 1 番目のオブジェクトを構成し、2 とラベル付けされたピクセルは 2 番目のオブジェクトを構成する、というように、次々にオブジェクトを構成します。数値ラベル イメージは、watershed や labelmatrix などのラベル付け関数から取得できます。

• categorical 行列。

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

cmap — カラーマップ

'jet' (既定値) | c 行 3 列の行列 | カラーマップ関数 | ハンドル

生成されるカラー イメージ RGB で使用されるカラーマップ。次のいずれかとして指定します。

値	説明
データ型が double の c 行 3 列の行列	各 c カラーを RGB 3 成分として指定するカラーマップ行列。c は、ラベル行列 L のラベル数 numlabels 以上でなければなりません。ラベル数は numlabels = max(L(:)) として計算できます。 c が numlabels より大きい場合、label2rgb は、行列の最初の numlabels 行のみを使用して RGB イメージを作成します。
カラーマップ関数	MATLAB® カラーマップ関数の名前。'jet' や 'gray' などです。サポートされているカラーマップの一覧については、colormap を参照してください。
カラーマップ ハンドル	カラーマップ関数のハンドル (@jet や @gray など)。

zerocolor — 塗りつぶし色

[1 1 1] (白) (既定値) | 3 要素ベクトル | 'b' | 'c' | 'g'

塗りつぶし色。RGB 3 成分を表す 3 要素ベクトルを指定するか、数値ラベル イメージの場合は次のカラーの省略形のいずれかを指定します。label2rgb はこの塗りつぶし色を、数値ラベル イメージの場合はラベル 0 に、カテゴリカル ラベル イメージの場合はラベル <undefined> に適用します。

値	色
'b'	blue
'c'	cyan
'g'	green
'k'	black
'm'	magenta
'r'	red
'w'	white
'y'	yellow

order — 色の順序

'noshuffle' (既定値) | 'shuffle'

色の順序。'noshuffle' または 'shuffle' を指定します。'noshuffle' の順序は、カラーマップの色をラベル行列領域に番号順で割り当てます。'shuffle' の順序は、疑似ランダムにカラーマップの色を割り当てます。

outputFormat — Output format

'image' (既定値) | 'triplets'

RGB に返される RGB データの出力形式。以下のいずれかとして指定します。

• 'image' — RGB イメージを返します。入力のラベル行列 L のサイズが M 行 N 列の場合、出力の RGB イメージのサイズは M x N x 3 です。

• 'triplets' — RGB カラーのリストを返します。出力のサイズは C 行 3 列の行列であり、入力のラベル行列にある C 個の各ラベルの RGB 3 成分が含まれます。

出力引数

RGB — RGB データ

数値行列

RGB データ。数値行列として返されます。

データ型: uint8

拡張機能

C/C++ コード生成

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

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

• label2rgb では C コードの生成がサポートされています (MATLAB Coder™ が必要)。詳細については、イメージ処理のコード生成を参照してください。

• データ型 categorical の入力ラベル イメージはサポートされていません。

• コードを生成する際、標準構文 RGB = label2rgb(L,cmap,zerocolor,order) を使用して最適な結果を得るには、以下を行います。

  • 少なくとも 2 つの入力引数、ラベル行列 L およびカラーマップ行列 cmap を渡します。

  • cmap は、データ型が double の c 行 3 列の行列でなければなりません。MATLAB のカラーマップ関数や、カラーマップ関数の関数ハンドルの名前は指定できません。

  • 背景色 zerocolor をいずれかの領域と同じ色に設定した場合、label2rgb では警告が表示されません。

  • order に値を指定する場合は、'noshuffle' でなければなりません。

スレッドベースの環境

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

この関数は、スレッドベースの環境を完全にサポートします。詳細については、Run MATLAB Functions in Thread-Based Environmentを参照してください。

バージョン履歴

R2006a より前に導入

参考

bwconncomp | bwlabel | bwlabeln | colormap | ismember | labelmatrix | watershed

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい