bwpropfilt

속성을 사용하여 이진 영상에서 객체 추출

구문

BW2 = bwpropfilt(BW,prop,range)

BW2 = bwpropfilt(BW,prop,n)

BW2 = bwpropfilt(BW,prop,n,keep)

BW2 = bwpropfilt(BW,I,prop,___)

BW2 = bwpropfilt(___,conn)

설명

BW2 = bwpropfilt(BW,prop,range)는 지정된 range에 속성 prop의 값이 속하는 이진 영상 BW로부터 모든 연결성분(객체)을 추출합니다. bwpropfilt는 기준을 충족하는 객체만 포함한 이진 영상 BW2를 반환합니다.

BW2 = bwpropfilt(BW,prop,n)은 지정된 속성 prop의 값을 기준으로 객체를 정렬하고, 상위 n개의 가장 큰 객체만 포함하는 이진 영상을 반환합니다. n번째에서 동순위가 발생하면 bwpropfilt는 처음 n개 객체만 BW2에 유지합니다.

BW2 = bwpropfilt(BW,prop,n,keep)은 속성 prop로 정렬된 경우 n개의 최대 객체 또는 n개의 최소 객체만 남기도록 지정합니다.

BW2 = bwpropfilt(BW,I,prop,___)는 회색조 영상 I의 명암 값과 속성 prop를 기준으로 객체를 정렬합니다.

BW2 = bwpropfilt(___,conn)은 픽셀 연결성 conn을 지정합니다.

예제

구멍 없는 영역 찾기

영상을 읽어 들인 후 이를 표시합니다.

BW = imread('text.png');
figure
imshow(BW)
title('Original Image')

필터링을 사용하여, 원래 영상에서 구멍이 없는 영역만 포함된 두 번째 영상을 만듭니다. 이러한 영역에서 오일러 수 속성은 1입니다. 필터링된 영상을 표시합니다.

BW2 = bwpropfilt(BW,'EulerNumber',[1 1]);
figure
imshow(BW2)
title('Regions with Euler Number == 1')

둘레가 가장 큰 객체 10개 찾기

영상을 읽어 들입니다.

BW = imread('text.png');

영상에서 둘레가 가장 큰 객체 10개를 찾아 필터링된 영상을 표시합니다.

BW2 = bwpropfilt(BW,'perimeter',10);
figure;
imshow(BW2)
title('Objects with the Largest Perimeters')

입력 인수

BW — 필터링할 영상

이진 영상

필터링할 영상으로, 이진 영상으로 지정됩니다.

데이터형: logical

prop — 필터링할 속성의 이름

문자형 벡터 | string형 스칼라

필터링할 속성의 이름으로, 다음 값 중 하나로 지정됩니다.

픽셀 값의 측정값

속성 이름	설명
"Area"	영역의 픽셀 수입니다.
"ConvexArea"	볼록 껍질의 픽셀 수입니다. 볼록 껍질은 영역을 포함할 수 있는 가장 작은 볼록 다각형입니다. 껍질 경계에 있는 픽셀을 분류하는 방법에 대한 자세한 내용은 Classify Pixels That Are Partially Enclosed by ROI 항목을 참조하십시오.
"Eccentricity"	영역과 같은 2차 모멘트를 갖는 타원의 이심률입니다. 이심률은 타원의 포커스와 타원의 주요 축 길이 간의 거리 비율입니다. 값은 [0, 1] 범위의 숫자입니다. (0과 1은 퇴화된 경우입니다. 이심률이 0인 타원은 실제로는 원이고, 이심률이 1인 타원은 선분입니다.)
"EquivDiameter"	영역과 같은 면적을 갖는 원의 지름(단위: 픽셀)으로, sqrt(4*Area/pi)로 계산됩니다.
"EulerNumber"	오일러 수(오일러 지표라고도 함)로, 1에서 영역의 구멍 수를 뺀 값으로 계산됩니다.
"Extent"	영역의 픽셀과 총 경계 상자의 픽셀 비율로, 경계 상자의 면적으로 나눈 Area로 계산됩니다.
"FilledArea"	영역의 모든 구멍을 채운 후 영역의 픽셀 수입니다.
"MajorAxisLength"	영역과 같은 정규화된 2차 중심 모멘트를 갖는 타원의 주요 축 길이(단위: 픽셀)입니다.
"MinorAxisLength"	영역과 같은 정규화된 2차 중심 모멘트를 갖는 타원의 보조 축 길이(단위: 픽셀)입니다.
"Orientation"	영역과 같은 2차 모멘트를 갖는 타원의 x축과 주요 축 간의 각도(단위: 도)입니다. 값은 범위 (–90, 90] 사이에 있습니다. 아래 그림은 타원의 좌표축과 방향을 나타낸 것입니다. 왼쪽 그림은 영상 영역과 해당 타원을 보여줍니다. 오른쪽은 같은 타원과, 좌표축을 나타내는 파란색 실선을 보여줍니다. 빨간색 점은 포커스입니다. 방향은 가로 점선과 주요 축 간의 각도입니다.
"Perimeter"	영역 경계 주변의 거리(단위: 픽셀)로, 영역 경계 주변에서 서로 인접해 있는 각 픽셀 쌍의 거리를 추가하여 계산됩니다. 아래 그림은 샘플 영역의 둘레 계산에 포함된 픽셀을 나타냅니다.
"Solidity"	볼록 껍질에도 있고 영역에도 있는 픽셀 비율로, Area/ConvexArea로 계산됩니다.

마커 영상 I를 함수의 입력 인수로 포함할 경우 이 표에 나와 있는 픽셀 값 측정 속성을 지정할 수 있습니다.

픽셀 값의 측정값

속성 이름	설명
"MaxIntensity"	영역에서 가장 큰 명암을 갖는 픽셀 값입니다.
"MeanIntensity"	영역의 모든 명암 값의 평균입니다.
"MinIntensity"	영역에서 가장 낮은 명암을 갖는 픽셀 값입니다.

데이터형: char | string

range — 최소 속성값 및 최대 속성값

요소를 2개 가진 숫자형 벡터

최소 속성값 및 최대 속성값으로, [low high] 형식의, 요소를 2개 가진 숫자형 벡터로 지정됩니다. 값은 감소하지 않아야 합니다.

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

n — 반환할 객체의 개수

양의 정수

반환할 객체의 개수로, 양의 정수로 지정됩니다.

데이터형: double

keep — 유지할 객체

"largest" (디폴트 값) | "smallest"

유지할 객체로, "largest" 또는 "smallest"로 지정됩니다.

데이터형: char | string

I — 마커 영상

회색조 영상

마커 영상으로, 입력 이진 영상과 크기가 같은 회색조 영상으로 지정됩니다. 회색조 영상에서 명암 값은 입력 이진 영상의 영역을 정의합니다.

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

conn — 픽셀 연결성

8 (디폴트 값) | 4 | 0과 1로 구성된 3×3 행렬

픽셀 연결성으로, 다음 값 중 하나로 지정됩니다.

값	의미
2차원 연결성
4	경계가 서로 닿으면 픽셀이 연결됩니다. 두 개의 인접한 픽셀이 모두 켜져 있고 가로 또는 세로 방향으로 연결되어 있으면 두 픽셀은 동일한 객체에 속합니다.	현재 픽셀은 회색으로 표시됩니다.
8	경계 또는 코너가 서로 닿으면 픽셀이 연결됩니다. 두 개의 인접한 픽셀이 모두 켜져 있고 가로, 세로 또는 대각선 방향으로 연결되어 있으면 두 픽셀은 동일한 객체에 속합니다.	현재 픽셀은 회색으로 표시됩니다.

0과 1로 구성된 3×3 행렬을 지정하여 더 일반적인 방식으로 연결성을 정의할 수도 있습니다. 값이 1인 요소는 conn의 중앙 요소를 기준으로 하여 이웃 픽셀의 위치를 정의합니다. 행렬은 그 중앙 요소를 기준으로 대칭이어야 합니다.

데이터형: double | logical

출력 인수

BW2 — 필터링된 영상

이진 영상

필터링된 영상으로, BW와 같은 크기의 이진 영상으로 반환됩니다.

팁

• bwpropfilt는 bwconncomp 함수를 사용하여 연결성분을 찾습니다. 그런 다음 bwpropfilt는 regionprops 함수를 사용하여 그러한 연결성분의 속성을 계산합니다.

확장 기능

C/C++ 코드 생성

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

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

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

• prop 및 keep 인수는 컴파일타임 상수여야 합니다.

• conn을 3×3 행렬로 지정하면 행렬은 [0 1 0;1 1 1;0 1 0] 또는 ones(3)이어야 합니다.

버전 내역

R2014b에 개발됨

R2022b: MATLAB Coder를 사용하여 C 코드 생성하기

이제 bwpropfilt 함수는 C 코드 생성을 지원합니다(MATLAB Coder가 필요함).

참고 항목

영상 영역 분석기 | regionprops | bwareafilt | bwareaopen | bwconncomp | conndef

도움말 항목

• Filter Images on Properties Using Image Region Analyzer App

×

예제 열기

이 예제의 수정된 버전이 있습니다. 사용자가 편집한 내용을 반영하여 이 예제를 여시겠습니까?

아니요, 수정된 버전을 덮어씁니다. 예