ordfilt2

2차원 순서-통계량 필터링

구문

B = ordfilt2(A,order,domain)

B = ordfilt2(A,order,domain,S)

B = ordfilt2(___,padopt)

설명

B = ordfilt2(A,order,domain)은 A의 각 요소를 domain의 0이 아닌 요소로 지정된 이웃을 정렬한 집합의 order번째 요소로 대체합니다.

B = ordfilt2(A,order,domain,S)는 ordfilt2가 domain의 0이 아닌 요소에 대응하는 S 값을 가산 오프셋으로 사용하여 A를 필터링합니다. 이 구문을 사용하여, 회색조 팽창과 침식 등 회색조 모폴로지 연산을 구현할 수 있습니다.

B = ordfilt2(___,padopt)는 ordfilt2가 어떤 방법으로 행렬 경계를 채울지 지정한 padopt를 사용하여 A를 필터링합니다.

예제

최솟값 필터를 사용하여 영상 필터링하기

영상을 작업 공간으로 읽어 들인 후 표시합니다.

A = imread('snowflakes.png');
figure
imshow(A)

영상을 필터링하고 결과를 표시합니다.

B = ordfilt2(A,25,true(5));
figure
imshow(B)

입력 인수

A — 필터링할 데이터

2차원 숫자형 행렬 | 2차원 논리형 행렬

필터링할 데이터로, 2차원 숫자형 행렬 또는 2차원 논리형 행렬로 지정됩니다.

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

order — 대상 픽셀을 대체할 요소

양의 정수

대상 픽셀을 대체할 요소로, 실수형 정수 스칼라로 지정됩니다.

데이터형: double

domain — 이웃

2차원 숫자형 행렬 | 2차원 논리형 행렬

이웃으로, 1 및 0을 포함하는 숫자형 행렬 또는 논리형 행렬로 지정됩니다. domain은 이진 영상 연산에 사용되는 구조 요소와 동일합니다. 값이 1인 요소는 필터링 연산에서 이웃을 정의합니다. 다음 표에는 일반적인 필터의 예가 나와 있습니다.

필터링 연산의 유형	샘플 코드	이웃	선택된 요소를 나타내는 샘플 영상 데이터
중앙값 필터	B = ordfilt2(A,5,ones(3,3))
최솟값 필터	B = ordfilt2(A,1,ones(3,3))
최댓값 필터	B = ordfilt2(A,9,ones(3,3))
북쪽, 동쪽, 남쪽, 서쪽 이웃의 최소값	B = ordfilt2(A,1,[0 1 0; 1 0 1; 0 1 0])

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

S — 가산 오프셋

숫자형 행렬

가산 오프셋으로, domain과 크기가 같은 숫자형 행렬로 지정됩니다.

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

padopt — 채우기 옵션

"zeros" (디폴트 값) | "symmetric"

채우기 옵션으로, 다음 값 중 하나로 지정됩니다.

옵션	설명	예
"zeros"	값 0으로 배열 경계를 채웁니다.	$$\left[\begin{array}{ccc}3& 1& 4\\ 1& 5& 9\\ 2& 6& 5\end{array}\right]\to \left[\begin{array}{ccccccc}0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 3& 1& 4& 0& 0\\ 0& 0& 1& 5& 9& 0& 0\\ 0& 0& 2& 6& 5& 0& 0\\ 0& 0& 0& 0& 0& 0& 0\\ 0& 0& 0& 0& 0& 0& 0\end{array}\right]$$
"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]$$

데이터형: char | string

출력 인수

B — 필터링된 데이터

2차원 숫자형 행렬 | 2차원 논리형 행렬

필터링된 데이터로, 입력 데이터 A와 동일한 데이터형의 2차원 숫자형 행렬 또는 2차원 논리형 행렬로 반환됩니다.

팁

• 값이 0인 요소가 포함되지 않은 대규모 영역 행렬을 사용하는 경우, A가 정수 데이터 형식(uint8형, int8형, uint16형, int16형)일 때 ordfilt2가 더 나은 성능을 보일 수 있습니다. 16비트 데이터형보다 uint8형과 int8형에서 속도 향상이 더 큽니다. 8비트 데이터 형식의 경우 영역 행렬은 7개 이상의 행을 포함해야 합니다. 16비트 데이터 형식의 경우 영역 행렬은 3개 이상의 행과 520개 이상의 요소를 포함해야 합니다.

참고 문헌

[1] Haralick, Robert M., and Linda G. Shapiro, Computer and Robot Vision, Volume I, Addison-Wesley, 1992.

[2] Huang, T. S., G. J. Yang, and G. Y. Tang. "A fast two-dimensional median filtering algorithm.", IEEE transactions on Acoustics, Speech and Signal Processing, Vol ASSP 27, No. 1, February 1979.

확장 기능

C/C++ 코드 생성

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

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

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

• 코드를 생성할 때 padopt 인수는 컴파일타임 상수여야 합니다.

GPU 코드 생성

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

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

• GPU 코드를 생성하려면 입력값에 범위가 지정되어 있어야 합니다. 입력값이 가변 차원이면 C 코드가 생성됩니다.

• 코드를 생성할 때 padopt 인수는 컴파일타임 상수여야 합니다.

• 필터링 연산에서 이웃을 정의하는 domain 값의 크기가 11×11보다 크면, 생성된 GPU 코드가 최적화되지 않습니다.

  성능 개선을 위해, coder.gpuConfig (GPU Coder) 객체의 StackLimitPerThread 옵션을 Inf로 설정해 보십시오.

스레드 기반 환경

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

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

버전 내역

R2006a 이전에 개발됨

R2022b: 스레드 기반 환경 지원

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

참고 항목

medfilt2

도움말 항목

• imfilter 경계선 채우기 옵션