imboxfilt

영상에 대한 2차원 상자 필터링

구문

B = imboxfilt(A)

B = imboxfilt(A,filterSize)

B = imboxfilt(___,Name=Value)

설명

B = imboxfilt(A)는 2차원의 3×3 상자 필터를 사용하여 영상 A를 필터링합니다. 상자 필터는 평균 필터라고도 합니다.

B = imboxfilt(A,filterSize)는 filterSize로 지정된 크기를 갖는 2차원 상자 필터로 영상 A를 필터링합니다.

B = imboxfilt(___,Name=Value)는 이름-값 쌍 인수를 사용하여 필터링의 특성을 제어합니다.

예제

지정된 이웃에 대해 평균 필터 계산하기

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

A = imread("cameraman.tif");

11×11 필터를 사용하여 평균 필터링을 수행합니다.

localMean = imboxfilt(A,11);

원본 영상과 필터링된 영상을 나란히 표시합니다.

imshowpair(A,localMean,"montage")

지정된 이웃에 대해 국소 영역 합계 계산하기

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

A = imread('cameraman.tif');

정수 오버플로를 방지하기 위해 영상의 데이터형을 double로 변경합니다.

A = double(A);

15×15 상자 필터를 사용하여 국소 영역 합계를 계산하고 영상을 필터링합니다. 국소 영역의 평균값이 아닌 합계를 계산하기 위해 NormalizationFactor 파라미터를 1로 설정합니다.

localSums = imboxfilt(A, 15, 'NormalizationFactor',1);

원본 영상과 필터링된 영상을 나란히 표시합니다.

imshowpair(A,localSums,'montage')

입력 인수

A — 필터링할 영상

숫자형 배열

필터링할 영상으로, 임의의 차원의 숫자형 배열로 지정됩니다. 입력 영상이 3차원 이상이면(ndims(I)>2)(예: RGB 영상) imboxfilt가 더 높은 차원을 따라 모든 2차원 평면에 대해 상자 필터링을 수행합니다.

A에 Infs 또는 NaNs 값이 있는 경우에는 imboxfilt의 동작이 정의되지 않습니다. 이 문제는 적분 영상에 기반한 필터링이 사용된 경우 발생할 수 있습니다. 출력값에서 Infs와 NaNs의 전파를 제한하려면, 대신 imfilter를 사용해 보십시오.

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

filterSize — 상자 필터의 크기

3 (디폴트 값) | 양의 홀수 정수 | 양의 홀수 정수로 구성된 요소를 2개 가진 벡터

상자 필터의 크기로, 양의 홀수 정수 또는 양의 홀수 정수로 구성된 요소를 2개 가진 벡터로 지정됩니다. filterSize가 스칼라이면 상자 필터는 정사각 필터입니다.

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

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: B = imboxfilt(A,5,Padding="circular")는 채우기 패턴을 "circular"로 지정합니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: B = imboxfilt(A,5,"Padding","circular");

Padding — 채우기 패턴

"replicate" (디폴트 값) | "circular" | "symmetric" | 숫자형 스칼라

채우기 패턴으로, 다음 값 중 하나 또는 숫자형 스칼라로 지정됩니다. 스칼라 값을 지정할 경우, 영상의 경계 밖에 있는 입력 영상 픽셀은 묵시적으로 그 스칼라 값을 갖는 것으로 간주됩니다.

값	설명
"circular"	영상의 경계 밖에 있는 입력 영상 값이 묵시적으로 입력 영상이 주기적이라고 간주하여 계산됩니다.
"replicate"	영상의 경계 밖에 있는 입력 영상 값이 가장 가까운 영상 테두리 값과 같은 것으로 간주됩니다.
"symmetric"	영상의 경계 밖에 있는 입력 영상 값이 배열 테두리를 기준으로 배열을 대칭 복사하여 계산됩니다.

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

NormalizationFactor — 상자 필터에 적용되는 정규화 인자

숫자형 스칼라

상자 필터에 적용되는 정규화 인자로, 숫자형 스칼라로 지정됩니다.

NormalizationFactor의 디폴트 값은 filterSize에 따라 달라집니다. filterSize가 스칼라인 경우 디폴트 값은 1/filterSize.^2입니다. filterSize가 요소를 2개 가진 벡터인 경우 디폴트 값은 1/prod(filterSize)입니다.

디폴트 NormalizationFactor는 평균 필터와 같은 효과를 냅니다. 즉, 출력 영상의 픽셀은 filterSize에 의해 결정된 이웃 영상의 국소 평균값입니다. 국소 영역 합계를 구하려면 NormalizationFactor를 1로 설정하십시오. 이러한 상황에서 오버플로를 방지하려면 입력 영상을 double형 클래스로 변환하여 배정밀도 영상을 사용해 보십시오.

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

출력 인수

B — 필터링된 영상

숫자형 배열

필터링된 영상으로, 입력 영상 A와 크기가 같은 숫자형 배열로 반환됩니다.

알고리즘

imboxfilt는 컨벌루션 기반 필터링 또는 적분 영상 필터링을 사용하여 필터링을 수행하며, 내부 발견법(Heuristic)을 기반으로 어느 필터링 방식을 사용할지 결정합니다.

확장 기능

C/C++ 코드 생성

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

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

• imboxfilt 함수는 C 코드 생성을 지원합니다(MATLAB^® Coder™가 필요함). 일반적인 MATLAB Host Computer 타깃 플랫폼을 선택할 경우 imboxfilt 함수는 미리 컴파일된 플랫폼별 공유 라이브러리를 사용하는 코드를 생성합니다. 공유 라이브러리를 사용하면 성능 최적화가 유지되지만 코드를 생성할 수 있는 타깃 플랫폼이 제한됩니다. 자세한 내용은 Types of Code Generation Support in Image Processing Toolbox 항목을 참조하십시오.

• 코드 생성 시, 모든 문자형 벡터 입력 인수는 컴파일타임 상수여야 합니다.

GPU 코드 생성

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

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

• 코드 생성 시, 모든 문자형 벡터 입력 인수는 컴파일타임 상수여야 합니다.

스레드 기반 환경

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

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

버전 내역

R2015b에 개발됨

R2022b: 스레드 기반 환경 지원

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

참고 항목

imboxfilt3 | imfilter | integralBoxFilter