imgaussfilt

영상에 대한 2차원 가우스 필터링

구문

B = imgaussfilt(A)

B = imgaussfilt(A,sigma)

B = imgaussfilt(___,Name=Value)

설명

B = imgaussfilt(A)는 표준편차가 0.5인 2차원 가우스 평활화 커널로 영상 A를 필터링한 후 필터링된 영상을 B로 반환합니다.

B = imgaussfilt(A,sigma)는 sigma로 지정된 표준편차를 갖는 2차원 가우스 평활화 커널로 영상 A를 필터링합니다.

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

예제

가우스 필터를 사용하여 영상 평활화하기

필터링할 영상을 읽어 들입니다.

I = imread("cameraman.tif");

표준편차가 2인 가우스 필터를 사용하여 영상을 필터링합니다.

Iblur = imgaussfilt(I,2);

원본 영상과 필터링된 영상을 몽타주 형태로 표시합니다.

montage({I,Iblur})
title("Original Image (Left) Vs. Gaussian Filtered Image (Right)")

입력 인수

A — 필터링할 영상

숫자형 배열

필터링할 영상으로, 임의의 차원의 숫자형 배열로 지정됩니다.

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

sigma — 가우스 분포의 표준편차

0.5 (디폴트 값) | 양수 | 양수 요소를 2개 가진 벡터

가우스 분포의 표준편차로, 양수 또는 양수 요소를 2개 가진 벡터로 지정됩니다. 스칼라를 지정하면 imgaussfilt는 정사각 가우스 커널을 사용합니다.

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

이름-값 인수

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

예: B = imgaussfilt(A,FilterSize=3);은 크기가 3인 필터를 지정합니다.

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

예: B = imgaussfilt(A,"FilterSize",3);

FilterSize — 가우스 필터의 크기

양의 홀수 정수 | 양의 홀수 정수로 구성된 요소를 2개 가진 벡터

가우스 필터의 크기로, 양의 홀수 정수 또는 양의 홀수 정수로 구성된 요소를 2개 가진 벡터로 지정됩니다. 스칼라를 지정하면 imgaussfilt는 정사각 필터를 사용합니다. 디폴트 필터 크기는 2*ceil(2*sigma)+1입니다.

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

Padding — 영상 채우기

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

영상 채우기로, 표의 값 중 하나로 지정됩니다.

값	설명	예
숫자형 스칼라 X	배열의 경계 밖에 있는 입력 배열 값에 값 X가 할당됩니다.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 3& 1& 4& 2& 2\\ 2& 2& 1& 5& 9& 2& 2\\ 2& 2& 2& 6& 5& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\\ 2& 2& 2& 2& 2& 2& 2\end{array}\right]$$ 이 배열은 값 2로 채운 경우를 보여줍니다.
"symmetric"	배열의 경계 밖에 있는 입력 배열 값은 배열 테두리를 기준으로 배열을 대칭 복사하여 계산됩니다.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}5& 1& 1& 5& 9& 9& 5\\ 1& 3& 3& 1& 4& 4& 1\\ 1& 3& 3& 1& 4& 4& 1\\ 5& 1& 1& 5& 9& 9& 5\\ 6& 2& 2& 6& 5& 5& 6\\ 6& 2& 2& 6& 5& 5& 6\\ 5& 1& 1& 5& 9& 9& 5\end{array}\right]$$
"replicate"	배열의 경계 밖에 있는 입력 배열 값은 가장 가까운 배열 테두리 값과 같은 것으로 간주됩니다.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}3& 3& 3& 1& 4& 4& 4\\ 3& 3& 3& 1& 4& 4& 4\\ 3& 3& 3& 1& 4& 4& 4\\ 1& 1& 1& 5& 9& 9& 9\\ 2& 2& 2& 6& 5& 5& 5\\ 2& 2& 2& 6& 5& 5& 5\\ 2& 2& 2& 6& 5& 5& 5\end{array}\right]$$
"circular"	배열의 경계 밖에 있는 입력 배열 값은 묵시적으로 입력 배열을 주기적이라고 간주하여 계산됩니다.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}5& 9& 1& 5& 9& 1& 5\\ 6& 5& 2& 6& 5& 2& 6\\ 1& 4& 3& 1& 4& 3& 1\\ 5& 9& 1& 5& 9& 1& 5\\ 6& 5& 2& 6& 5& 2& 6\\ 1& 4& 3& 1& 4& 3& 1\\ 5& 9& 1& 5& 9& 1& 5\end{array}\right]$$

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

FilterDomain — 필터링을 수행할 영역

"auto" (디폴트 값) | "spatial" | "frequency"

필터링을 수행할 영역으로, 다음 값 중 하나로 지정됩니다.

값	설명
"auto"	내부의 발견법(Heuristic)을 기반으로 공간 영역이나 주파수 영역에 컨벌루션을 수행합니다.
"frequency"	주파수 영역에서 컨벌루션을 수행합니다.
"spatial"	공간 영역에서 컨벌루션을 수행합니다.

데이터형: char | string

출력 인수

B — 필터링된 영상

숫자형 배열

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

팁

• 영상 A에 Inf 또는 NaN 값을 갖는 요소가 있으면, 주파수 영역 필터링을 위한 imgaussfilt 동작이 정의되지 않습니다. FilterDomain 이름-값 인수를 "frequency"로 설정하거나 "auto"로 설정한 상태에서 imgaussfilt가 주파수 영역 필터링을 사용하면, 이러한 현상이 발생할 수 있습니다. imfilter와 유사한 방식으로 출력값에서 Inf와 NaN의 전파를 제한하려면, FilterDomain 이름-값 인수를 "spatial"로 설정하는 것이 좋습니다.

• FilterDomain 이름-값 인수를 "auto"로 설정하면, imgaussfilt는 내부의 발견법(Heuristic)을 사용하여 공간 영역 필터링과 주파수 영역 필터링 중 어느 것이 더 빠른지 확인합니다. 이러한 발견법은 시스템 종속적이고, 구성에 따라 다를 수 있습니다. 최적의 성능을 위해 두 가지 옵션 "spatial"과 "frequency"를 모두 사용하여, 영상과 커널 크기에 가장 적합한 필터링 영역을 확인해 보십시오.

• Padding 이름-값 인수를 지정하지 않으면, imgaussfilt는 기본적으로 "replicate" 채우기를 사용하며, 이는 imfilter에서 사용하는 디폴트 값과 다릅니다.

확장 기능

C/C++ 코드 생성

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

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

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

• imgaussfilt 함수는 "frequency"로 지정된 FilterDomain 이름-값 인수를 지원하지 않습니다. 생성된 코드에서 필터링은 항상 공간 영역에 대해 수행됩니다.

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

GPU 코드 생성

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

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

• imgaussfilt 함수는 "frequency"로 지정된 FilterDomain 이름-값 인수를 지원하지 않습니다. 생성된 코드에서 필터링은 항상 공간 영역에 대해 수행됩니다.

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

스레드 기반 환경

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

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

GPU 배열

Parallel Computing Toolbox™를 사용해 GPU(그래픽스 처리 장치)에서 실행하여 코드 실행 속도를 높일 수 있습니다.

이 함수는 GPU 배열을 완전히 지원합니다. 자세한 내용은 GPU를 사용한 영상 처리 항목을 참조하십시오.

버전 내역

R2015a에 개발됨

R2022b: 스레드 기반 환경 지원

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

참고 항목

imgaussfilt3 | imfilter | fspecial

도움말 항목

• imfilter 경계선 채우기 옵션