mm_per_px_from_reference — MEASURE1D scale op

• 데이터 종류: measurement → measurement

• 호출: import fullseye as fs; fs.ledger.mm_per_px_from_reference(measured_px, known_mm)(구현을 직접 호출하려면 import measuring1d; measuring1d.mm_per_px_from_reference(measured_px, known_mm), 원장에서 가져오려면 opsmeasure1d.get("mm_per_px_from_reference"))

사용법

치수를 아는 기준물(스케일 바, 기준 구멍, 게이지)로부터 화소 피치 mm/px 를 구한다(보정).

mm_per_px = known_mm / measured_px. measured_px 에는 같은 광학계, 같은 작동 거리에서 이 계열의 op 가 실제로 잰 값(measure_pairs 의 width, apply_metrology_model 의 radius 의 2 배 등)을 넘긴다. 도면 값이나 공칭 배율로 정하면 작동 거리가 10 % 어긋날 때 모든 치수가 10 % 어긋난다.

• measured_px, known_mm: 유한한 양의 스칼라(그 밖에는 ValueError).

• 반환값: mm/px(float, measurement 형). pixel_to_world / table_px_to_mm 에 넘긴다.

• 원근이 작용하는 비스듬한 촬영에서는 위치마다 mm/px 가 바뀐다. 이 op 는 정면 촬영·일정 배율을 전제로 값 하나를 돌려줄 뿐 그 전제를 검증하지 않는다.

자세한 사용 가이드

• subpixel_measuring 패밀리 가이드

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

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

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

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

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

• example_inner_diameter_mm — py -3.11 examples/example_inner_diameter_mm.py

• example_scratch_width — py -3.11 examples/example_scratch_width.py

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

pixel_to_world

같은 카테고리(scale)

pixel_to_world · table_px_to_mm


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

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.