depth_from_focus — 3D structured_light op

• 데이터 종류: images → depth

• 호출: import fullseye as fs; fs.ledger.depth_from_focus(images, focus_positions=None)(구현을 직접 호출하려면 import ops3d; ops3d.depth_from_focus(images, focus_positions=None), 원장에서 가져오려면 ops3d.get("depth_from_focus"))

• 원장 경유의 반환값: fullseye.ledger.depth_from_focus(...) 는 선언된 out 형 depth 의 값만 반환합니다(실제 함수는 보조 정보도 반환). 버려진 쪽이 필요하면 fullseye.ledger.depth_from_focus.raw(...) 를 쓰거나 ops3d.depth_from_focus 를 직접 호출하세요.

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

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

사용법

초점을 바꾼 영상에서 픽셀별 최적 초점 위치를 높이/깊이로 추정한다.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

「焦点を変えた画像から高さ」「ピントを変えた複数画像から深さ」を求める shape-from-focus の入口。詳細な信頼度が必要なら reconstruction.depth_from_focus を直接呼び sharpness も確認する。

배경 지식 가이드(이 연산자 앞에 있는 물리·규약)

• depth_sensors — 깊이 센서 지식 — 측거 원리·실기 수치·결측이 나타나는 방식

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

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

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

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

• ftp_and_focus_depth — py -3.11 examples_3d/ftp_and_focus_depth.py

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

depth_to_points · tsdf_from_depth · to_points · fuse_to_voxel · depth_to_organized_points · normals_from_depth · occlusion_edges · bearing_angle_image

같은 카테고리(structured_light)

wrapped_phase · unwrap_phase_2d · graycode_decode · decode_fringe · fringe_ftp_phase · synthesize_fringes · absolute_phase · triangulate_column


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

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