image_points_to_world_plane — CALIB plane op

• 데이터 종류: table → keypoints

• 호출: import fullseye as fs; fs.ledger.image_points_to_world_plane(cam_par, pose, image_points, scale=1.0)(구현을 직접 호출하려면 import calib; calib.image_points_to_world_plane(cam_par, pose, image_points, scale=1.0), 원장에서 가져오려면 opscalib.get("image_points_to_world_plane"))

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

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

사용법

카메라 내부/외부 파라미터로 화소를 world 평면 z=0에 역투영한다(image_points_to_world_plane).

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

返り値は (N,2) の world 座標 × scale。視線が z=0 平面とカメラの前で交わらない画素(地平線より上など、交点がカメラの後ろ)は平面上の点を見ていないので、その行は nan。視線が平面と平行な画素は ValueError。

★2026-11-05(敵対的検証 geometry、未再現の疑いを確認): 以前は交点の係数 lam < 0(カメラの後ろ)でも有限の world 点を返していた(深度 −6.7 の点が「見えている点」として返った)。

자세한 사용 가이드

• camera_calibration 패밀리 가이드

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

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

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

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

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

• (아직 없음)

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

image_to_world_plane · camera_calibration · camera_calibration_lm · stereo_calibration_lm · vector_to_rigid · vector_to_similarity · hom_vector_to_proj_hom_mat2d

같은 카테고리(plane)

image_to_world_plane · contour_to_world_plane_xld · gen_image_to_world_plane_map · gen_radial_distortion_map


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

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