region op• 데이터 종류: region → region
• 호출: fullseye.apply(img, "r2_inner_circle", a=0.5, b=0.5)(2-D 는 이미지 1 장 + 스칼라 노브 2 개 a,b∈[0,1] 모델)
• HALCON 대응: inner_circle(의미·매개변수는 HALCON 레퍼런스가 참고가 됩니다)
*그림은 128×128 합성 입력에서 실제로 실행한 출력. 왼쪽이 입력, 오른쪽이 출력. 점군은 위에서 본 산점도(밝기 = z), 1-D 열은 꺾은선, 볼륨은 z 방향 최대값 투영, 동영상은 가운데 프레임, 복소 영상은 진폭이며, 그림이 되지 않는 반환값은 값 자체를 표시한다.*
노브 a 를 훑기(0.1 / 0.5 / 0.9, 다른 노브는 기본값):
▸ r2_inner_circle: 노브 a 스윕 (문서 사이트)
*노브 b 는 출력을 바꾸지 않는다(실측: 0.1 / 0.5 / 0.9에서 동일).*
단계(앞에 오는 op → 이 op, 왼쪽에서 오른쪽으로):
▸ r2_inner_circle: 단계 (문서 사이트)
다른 영상에서도(합성 장면 / 사진 / 동전. 윗줄이 입력, 아랫줄이 그 출력. 노브는 기본값):
▸ r2_inner_circle: 다른 입력 이미지 (문서 사이트)
최대 내접원을 마스크로 그립니다(a 가 그리는 반지름을 배율로. a=0.5 면 정확).
영역의 최대 내접원을 마스크로 그린다. 입력을 > 0.5로 전경 마스크로 바꾸고, scipy.ndimage.distance_transform_edt로 각 전경 화소에서 최근접 배경 화소까지의 거리를 구해, 그 최댓값 r0를 주는 화소를 중심 (cy, cx)로 한다(최댓값이 여럿이면 행 우선으로 첫 화소). 그리는 반경은 r = r0 * (0.6 + 0.8*a)로, a=0에서 0.6배, a=0.5에서 r0 그대로, a=1에서 1.4배(a는 [0,1]로 clip, 비유한이면 0.5). b는 사용하지 않는다.
반환값은 입력과 같은 형태의 float64 0/1 마스크(원판 (y-cy)^2+(x-cx)^2 <= r^2). 전경이 없으면 전부 0. 좌표는 (row, col).
주의: r0는 '배경 화소의 중심까지의 거리'이므로, a=0.5에서도 그린 원판은영역의 가장자리를 1 화소 정도 벗어날 수 있다(10x20 직사각형에서 2 화소, 반경 7의원판에서 12 화소의 바깥 화소를 실측). 엄밀하게 안쪽에 넣고 싶다면 a를 조금낮춘다. 영역이 여러 연결 성분으로 이루어진 경우에도 내접원은 1개뿐(가장 굵은 성분의것). 3차원 배열 (H,W,C)은 (H, W*C)로 평탄화되므로 컬러 영상은 넘기지 않는다. 전단에 threshold나 select_largest, 짝이 되는 외접원은 r2_smallest_circle(양자의 반경비가 진원도의 대략적인 지표가 된다).
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
아래 프로그램은 실제로 실행됨을 확인했습니다(그림과 같은 입력). Studio 도움말에서는 이 블록이 버튼이 되어 즉시 불러와 실행할 수 있습니다.
threshold 0.50 0.50 r2_inner_circle 0.50 0.50
• gallery2d_region — py -3.11 examples/gallery2d_region.py
region 를 입력으로 받는 것)identity · reg_erode · reg_dilate · reg_open · reg_close · fill_holes · select_largest · remove_small
region)reg_erode · reg_dilate · reg_open · reg_close · fill_holes · select_largest · remove_small · invert_region
*Provenance: ops.py — 2D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.