measure_pos — MEASURE1D `caliper` op

• 데이터 종류: image2d × measurehandle → table

• 호출: import fullseye as fs; fs.ledger.measure_pos(image, measure, sigma=1.0, threshold=0.1, transition='all')(구현을 직접 호출하려면 import measuring1d; measuring1d.measure_pos(image, measure, sigma=1.0, threshold=0.1, transition='all'), 원장에서 가져오려면 opsmeasure1d.get("measure_pos"))

• HALCON 대응: measure_pos(의미·매개변수는 HALCON 레퍼런스가 참고가 됩니다)

• GPU: 없음(CPU 참조 구현만)

사용법

측정선 위의 에지 위치(서브픽셀)와 진폭을 추출한다(measure_pos).

각 에지: pos(샘플 index, 사각형은 시작점부터의 px) / dist(시작점부터의거리 [px]) / row, col / amplitude(부호 있는 그레이 차) / polarity ("positive" = 측정 방향으로 밝아진다). threshold 는 |amplitude| 의 하한, transition 은 "all" / "positive" / "negative".

빈 입력(image 이(가) 0 개 요소)은 ValueError 를 발생시킨다. ★입력의 관문(2026-11-09): 비유한 화소(NaN/inf)를 포함한 영상은 ValueError(에지의 1 화소 앞의 NaN으로 에지가 조용히 사라지고, 멀리 있으면 조용히 통과했다). sigma < 0도 ValueError (sigma = 0은 평활 없음, 음수는 조용히 0과 같아졌다). 측정선의 점(rows/cols)이 영상 밖 [-0.5, H-0.5] × [-0.5, W-0.5]로 나가면 RuntimeWarning (밖은 최근방 외삽으로, 보이지 않는 곳을 재고 있다), 전부 밖이면 ValueError(반환값이 list이므로 표시를 돌려줄 수 없다). 올바른 입력의 결과는 변하지 않는다.

자세한 사용 가이드

• subpixel_measuring 패밀리 가이드

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• poc_barcode_1d — py -3.11 examples/poc_barcode_1d.py

• poc_battery_electrode_breathing — py -3.11 examples/poc_battery_electrode_breathing.py

• poc_calipers_under_illusion — py -3.11 examples/poc_calipers_under_illusion.py

• poc_dimensional_inspection — py -3.11 examples/poc_dimensional_inspection.py

• poc_screw_thread_metrology — py -3.11 examples/poc_screw_thread_metrology.py

• poc_solar_limb_darkening — py -3.11 examples/poc_solar_limb_darkening.py

• poc_telecentric_metrology — py -3.11 examples/poc_telecentric_metrology.py

• poc_tree_ring_dendro — py -3.11 examples/poc_tree_ring_dendro.py

• poc_water_level — py -3.11 examples/poc_water_level.py

• poc_weld_bead_profile — py -3.11 examples/poc_weld_bead_profile.py

• poc_weld_radiograph_porosity — py -3.11 examples/poc_weld_radiograph_porosity.py

타입이 이어지는 다음 연산자(`table` 를 입력으로 받는 것)

table_px_to_mm

같은 카테고리(`caliper`)

gen_measure_rectangle2 · gen_measure_arc · translate_measure · measure_pairs · fuzzy_measure_pairing

*Provenance: measuring1d.py — MEASURE1D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

measure_pos — MEASURE1D caliper op

사용법