imhist

영상 데이터의 히스토그램

구문

[counts,binLocations] = imhist(I)

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

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

imhist(___)

설명

[counts,binLocations] = imhist(I)는 회색조 영상 I의 히스토그램을 계산합니다. imhist 함수는 히스토그램 도수를 counts로 반환하고 Bin 위치를 binLocations로 반환합니다. 히스토그램의 Bin 개수는 영상 유형에 따라 결정됩니다.

[counts,binLocations] = imhist(I,n)은 히스토그램을 계산하는 데 사용되는 Bin 개수 n을 지정합니다.

[counts,binLocations] = imhist(X,cmap)은 컬러맵 cmap을 갖는 인덱스 영상 X의 히스토그램을 계산합니다. 히스토그램의 컬러맵에는 각 항목마다 Bin이 하나씩 있습니다.

imhist(___)는 히스토그램의 플롯을 표시합니다. 입력 영상이 인덱스 영상인 경우, 히스토그램은 픽셀 값의 분포를 컬러맵 cmap의 컬러바 위에 표시합니다.

예제

히스토그램 계산하기

회색조 영상을 작업 공간으로 읽어 들입니다.

I = imread('pout.tif');

영상의 히스토그램을 표시합니다. I는 회색조 영상이므로, 기본적으로 히스토그램은 256개의 Bin을 가집니다.

imhist(I)

3차원 명암 영상의 히스토그램 표시하기

3차원 데이터셋을 불러옵니다.

load mristack

데이터의 히스토그램을 표시합니다. 영상이 회색조 영상이므로, imhist는 기본적으로 256개의 Bin을 사용합니다.

imhist(mristack)

입력 인수

I — 회색조 영상

숫자형 배열

회색조 영상으로, 임의 차원의 숫자형 배열로 지정됩니다. imhist 함수는 double 및 single 데이터형의 영상이 [0, 1] 범위의 값을 가질 것으로 예상합니다. I에 [0, 1] 범위 밖에 있는 값이 있는 경우 rescale 함수를 사용하여 값을 예상 범위로 다시 스케일링할 수 있습니다.

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

n — Bin 개수

양의 정수

Bin 개수로, 양의 정수로 지정됩니다. I가 회색조 영상이면, imhist는 Bin을 256개(디폴트 값) 사용합니다. I가 이진 영상이면, imhist는 Bin을 두 개 사용합니다.

예: 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 — Bin 위치

숫자형 배열

Bin 위치로, 숫자형 배열로 반환됩니다.

팁

• 회색조 영상에서 n개의 히스토그램 Bin은 너비가 A/(n−1)인 반열린 구간에 각각 해당합니다. 특히 pth Bin은 다음의 반열린 구간에 해당합니다.

  $$\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 함수는 미리 컴파일된 플랫폼별 공유 라이브러리를 사용하는 코드를 생성합니다. 공유 라이브러리를 사용하면 성능 최적화가 유지되지만 코드를 생성할 수 있는 타깃 플랫폼이 제한됩니다. 자세한 내용은 Types of Code Generation Support in 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(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

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

• imhist는 GPU에서 인덱스 영상을 지원하지 않습니다.

• GPU에서 출력 인수를 생략할 경우 imhist는 히스토그램을 표시하지 않습니다. 이 경우 이 함수는 히스토그램 도수를 변수 ans에 반환하지만, 히스토그램의 Bin 위치는 반환하지 않습니다.

자세한 내용은 GPU를 사용한 영상 처리 항목을 참조하십시오.

버전 내역

R2006a 이전에 개발됨

R2022b: 스레드 기반 환경 지원

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

참고 항목

histeq | histogram | stem