label2rgb

레이블 행렬을 RGB 영상으로 변환

구문

RGB = label2rgb(L)

RGB = label2rgb(L,cmap)

RGB = label2rgb(L,cmap,zerocolor)

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

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,colorAssignment)는 label2rgb가 레이블 행렬의 영역에 색을 할당하는 방법을 제어합니다.

RGB = label2rgb(___,OutputFormat=outputFormat)을 사용하면 함수가 RGB 영상 대신에 고유 색 목록을 반환하도록 지정할 수 있습니다.

R2021a 이전 릴리스에서는 이와 동일한 역할을 하는 RGB = label2rgb(__,"OutputFormat",outputFormat) 구문을 사용하십시오.

예제

색을 사용하여 레이블 행렬의 요소 강조 표시하기

영상을 읽어 들여 표시합니다.

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

영상에서 레이블 행렬을 만듭니다.

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

디폴트 설정을 사용하여 레이블 행렬을 RGB 영상으로 변환합니다. 배경 픽셀은 흰색입니다.

RGB = label2rgb(L);
imshow(RGB)

선택적 파라미터를 지정하여 레이블 행렬을 RGB 영상으로 변환합니다. 이 예제에서는 "spring" 컬러맵을 사용하고, 배경 픽셀을 녹청색으로 설정하며, 레이블에 할당하는 색을 무작위로 선택합니다.

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

입력 인수

L — 레이블 영상

음이 아닌 정수로 구성된 행렬 | categorical형 행렬

인접 영역의 레이블 영상으로, 다음 중 하나로 지정됩니다.

• 음이 아닌 정수로 구성된 행렬. 0으로 레이블이 지정된 픽셀은 배경입니다. 1로 레이블이 지정된 픽셀이 첫 번째 객체가 되고, 2로 레이블이 지정된 픽셀이 두 번째 객체가 되는 방식입니다. watershed 또는 labelmatrix와 같은 레이블 지정 함수에서 숫자형 레이블 영상을 얻을 수 있습니다.

• categorical형 행렬.

데이터형: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical

cmap — 컬러맵

"jet" (디폴트 값) | c×3 행렬 | 컬러맵 함수 | 핸들

생성된 컬러 영상 RGB에 사용되는 컬러맵으로, 다음 중 하나로 지정됩니다.

값	설명
double 데이터형의 c×3 행렬	각각이 RGB 3색인 c개의 색을 지정하는 컬러맵 행렬입니다. c는 레이블 행렬 L의 레이블 수 numlabels보다 크거나 같아야 합니다. 레이블 수는 numlabels = max(L(:))로 계산할 수 있습니다. c가 numlabels보다 크면 label2rgb는 행렬의 처음 numlabels개 행만 사용하여 RGB 영상을 만듭니다.
컬러맵 함수	"jet" 또는 "gray" 같은 MATLAB® 컬러맵 함수 이름. 지원되는 컬러맵 목록은 colormap을 참조하십시오.
컬러맵 핸들	@jet 또는 @gray 같은 컬러맵 함수 핸들.

zerocolor — 채우기 색

[1 1 1](흰색) (디폴트 값) | 요소를 3개 가진 벡터 | "b" | "c" | "g"

채우기 색으로, 숫자형 레이블 영상의 경우 다음 색 약어 중 하나로 지정되거나 RGB 3색을 나타내는 요소를 3개 가진 벡터로 지정됩니다. label2rgb는 숫자형 레이블 영상에는 채우기 색을 레이블 0에 적용하고, categorical형 레이블 영상에는 레이블 <undefined>에 적용합니다.

값	색
"b"	파란색
"c"	녹청색
"g"	녹색
"k"	검은색
"m"	자홍색
"r"	빨간색
"w"	흰색
"y"	노란색

colorAssignment — 색 할당

"noshuffle" (디폴트 값) | "shuffle" | "contrasting-neighbors"

색 할당으로, 다음 값 중 하나로 지정됩니다.

• "noshuffle" — 컬러맵 색을 숫자순으로 레이블 행렬 영역에 할당합니다. 각 영역에는 고유한 색이 있습니다.

• "shuffle" — 컬러맵 색을 의사 무작위 방식으로 할당합니다. 각 영역에는 고유한 색이 있습니다.

• "contrasting-neighbors" (R2025a 이후) — 컬러맵 색의 일부를 할당하여 인접 영역 간의 대비를 최대화합니다. 각각의 색이 여러 레이블에 대응될 수 있습니다.

outputFormat — 출력 형식

"image" (디폴트 값) | "triplets"

RGB에 반환되는 RGB 데이터의 출력 형식으로, 다음 중 하나로 지정됩니다.

• "image" — RGB 영상을 반환합니다. 입력 레이블 행렬 L의 크기가 M×N이면 출력 RGB 영상의 크기는 M×N×3입니다.

• "triplets" — RGB 색 목록을 반환합니다. 출력값의 크기는 입력 레이블 행렬의 각 C 레이블에 대해 RGB 3색을 포함하는 C×3 행렬입니다.

출력 인수

RGB — RGB 데이터

숫자형 행렬

RGB 데이터로, 숫자형 행렬로 반환됩니다.

데이터형: uint8

확장 기능

C/C++ 코드 생성

MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• label2rgb 함수는 C 및 C++ 코드 생성을 지원합니다(MATLAB Coder™가 필요함). 자세한 내용은 Code Generation for Image Processing 항목을 참조하십시오.

• 데이터형이 categorical형인 입력 레이블 영상은 지원되지 않습니다.

• 표준 구문 RGB = label2rgb(L,cmap,zerocolor,colorAssignment)를 사용할 때 최상의 결과를 얻으려면 코드 생성 시 다음과 같이 하십시오.

  • 최소 두 개의 입력 인수, 즉 레이블 행렬 L과 컬러맵 행렬 cmap을 제출합니다.

  • cmap이 double 데이터형의 c×3 행렬이어야 합니다. MATLAB 컬러맵 함수의 이름이나 컬러맵 함수의 함수 핸들은 지정할 수 없습니다.

  • 배경색 zerocolor를 영역 중 하나와 동일한 색으로 설정할 경우 label2rgb에서 경고가 발생되지 않습니다.

  • colorAssignment에 대한 값을 제공하는 경우 값은 "noshuffle"이어야 합니다.

GPU 코드 생성

GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

사용법 관련 참고 및 제한 사항:

• 데이터형이 categorical형인 입력 레이블 영상은 지원되지 않습니다.

• 표준 구문 RGB = label2rgb(L,cmap,zerocolor,colorAssignment)를 사용할 때 최상의 결과를 얻으려면 코드 생성 시 다음과 같이 하십시오.

  • 최소 두 개의 입력 인수, 즉 레이블 행렬 L과 컬러맵 행렬 cmap을 제출합니다.

  • cmap이 double 데이터형의 c×3 행렬이어야 합니다. MATLAB 컬러맵 함수의 이름이나 컬러맵 함수의 함수 핸들은 지정할 수 없습니다.

  • 배경색 zerocolor를 영역 중 하나와 동일한 색으로 설정할 경우 label2rgb에서 경고가 발생되지 않습니다.

  • colorAssignment에 대한 값을 제공하는 경우 값은 "noshuffle"이어야 합니다.

스레드 기반 환경

MATLAB®의 backgroundPool을 사용해 백그라운드에서 코드를 실행하거나 Parallel Computing Toolbox™의 ThreadPool을 사용해 코드 실행 속도를 높일 수 있습니다.

이 함수는 스레드 기반 환경을 완전히 지원합니다. 자세한 내용은 스레드 기반 환경에서 MATLAB 함수 실행하기 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2025a: 인접 레이블과의 색 대비 향상

인접 영역이 시각적으로 구별되는 색을 가지도록 하려면 colorAssignment 인수를 새 값 "contrasting-neighbors"로 지정하십시오.

R2022b: GPU Coder를 사용하여 CUDA 코드 생성

이제 label2rgb 함수는 최적화된 CUDA^® 코드 생성을 지원합니다(GPU Coder™가 필요함).

R2021b: 스레드 기반 환경 지원

label2rgb 함수는 이제 스레드 기반 환경을 지원합니다.

참고 항목

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

도움말 항목

• Get Started with Image Segmentation
• 딥러닝을 사용한 의미론적 분할 시작하기 (Computer Vision Toolbox)