이 번역 페이지는 최신 내용을 담고 있지 않습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.

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)

CC2 = bwpropfilt(CC,prop,range)

CC2 = bwpropfilt(CC,prop,n)

CC2 = bwpropfilt(CC,prop,n,keep)

CC2 = bwpropfilt(CC,I,prop,___)

설명

이진 영상 내의 객체

BW2 = bwpropfilt(BW,prop,range)는 이진 영상 BW에서 속성 prop의 값이 range에 지정된 범위에 속하는 모든 객체를 추출합니다. 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을 지정합니다.

연결성분 구조체 내의 객체

CC2 = bwpropfilt(CC,prop,range)는 CC에서 속성 prop의 값이 range에 지정된 범위에 속하는 연결성분을 반환합니다.

CC2 = bwpropfilt(CC,prop,n)은 상위 n개의 가장 큰 연결성분을 반환합니다. n번째에서 동순위가 발생하면 bwpropfilt는 처음 n개 객체만 CC2에 유지합니다.

CC2 = bwpropfilt(CC,prop,n,keep)은 속성 prop로 정렬된 경우 n개의 가장 큰 연결성분 또는 n개의 가장 작은 연결성분만 남기도록 지정합니다.

CC2 = bwpropfilt(CC,I,prop,___)는 회색조 영상 I의 명암 값과 속성 prop를 기준으로 연결성분을 정렬합니다.

예제

구멍 없는 영역 찾기

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

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')

여러 영상 속성에 대해 필터링하기

영상을 읽어 들여 표시합니다.

I = imread("blobs.png");
imshow(I)

연결성분 구조체를 만듭니다.

CC = bwconncomp(I);

구조체를 필터링하여 둥근 객체를 유지합니다. 필터링된 영상을 표시합니다.

CC = bwpropfilt(CC,"Circularity",[0.7 1]);
imshow(cc2bw(CC))

구조체를 다시 필터링하여 크기가 큰 객체를 유지합니다. 필터링된 영상을 표시합니다.

CC = bwpropfilt(CC,"Area",[20 Inf]);
imshow(cc2bw(CC))

입력 인수

BW — 필터링할 이진 영상

논리형 행렬

필터링할 이진 영상으로, 논리형 행렬로 지정됩니다.

bwpropfilt는 bwconncomp 함수를 사용하여 영상 내 연결성분을 찾습니다.

데이터형: logical

CC — 필터링할 연결성분

구조체

필터링할 연결성분으로, 구조체로 지정됩니다. 연결성분 구조체는 bwconncomp 함수를 사용하여 이진 영상에서 구할 수 있습니다.

데이터형: struct

prop — 필터링할 속성의 이름

문자형 벡터 | string형 스칼라

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

픽셀 값의 측정값

속성 이름	설명
"Area"	영역의 픽셀 수입니다.
"Circularity"	객체의 원형률. 원형성 값은 다음과 같이 계산됩니다. (4*pi*Area/Perimeter^2)*(1 - 0.5/r)^2 여기서 r = Perimeter/(2*pi) + 0.5입니다. 최대 원형성 값은 1입니다.
"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 — 마커 영상

회색조 영상

마커 영상으로, 회색조 영상으로 지정됩니다. 회색조 영상에서 명암 값은 입력 이진 영상의 영역을 정의합니다. 마커 영상은 이진 영상 BW와 크기가 같거나, 연결성분 구조체의 ImageSize 필드와 일치해야 합니다.

데이터형: 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와 크기가 같은 논리형 행렬로 반환됩니다.

CC2 — 필터링된 연결성분

구조체

필터링된 연결성분으로, 구조체로 반환됩니다.

팁

• bwpropfilt는 regionprops 함수를 사용하여 연결성분의 속성을 계산합니다.

• 여러 영상 속성에 대해 효율적으로 필터링하려면 동일한 연결성분 구조체를 사용하여 bwpropfilt를 여러 번 호출합니다.

확장 기능

C/C++ 코드 생성

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

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

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

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

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

• CC를 인수로 지정해서 bwpropfilt 함수에 대한 코드를 생성하는 경우 CC.PixelIdxList는 동종이어야 합니다. 다음 코드는 makeHomogeneous (MATLAB Coder) 함수를 사용하여 CC.PixelIdxList를 동종으로 만드는 방법을 보여줍니다.

  CC = bwconncomp(BW);
  typeCC = coder.typeof(CC);
  typeCC.Fields.PixelIdxList = makeHomogeneous(typeCC.Fields.PixelIdxList);
  
  codegen bwpropfilt -args {typeCC,coder.Constant("Area"),10}

  래퍼 함수에 대한 코드를 생성하는 경우에는 CC.PixelIdxList를 동종으로 만들 필요가 없습니다. 예를 들어 다음 명령은 myFunction이라는 래퍼 함수에 대한 코드를 생성합니다.

  codegen myFunction -args {BW}

  다음은 bwpropfilt 함수에 대한 호출을 포함하는 래퍼 함수 myFunction에 대한 샘플 정의입니다.

  function out = myFunction(BW) %#codegen
      CC = bwconncomp(BW);
      CC2 = bwpropfilt(CC,"Area",10);
      out = cc2bw(CC2);
  end

버전 내역

R2014b에 개발됨

R2024a: 연결성분의 속성에 대한 필터링

이제 객체를 연결성분 구조체 CC로 지정할 수 있습니다.

R2024a: 원형성 측정

이제 bwpropfilt는 이진 영상에서 영역의 원형성을 측정합니다. 원형성을 측정하려면 properties 인수를 지정할 때 "Circularity"를 포함하십시오.

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

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

참고 항목

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

도움말 항목

• Filter Images on Properties Using Image Region Analyzer App