optics op• 데이터 종류: vector × normals → normals
• 호출: import fullseye as fs; fs.ledger.refract(d, n, eta1=1.0, eta2=1.5)(구현을 직접 호출하려면 import match3d; match3d.refract(d, n, eta1=1.0, eta2=1.5), 원장에서 가져오려면 ops3d.get("refract"))
스넬 굴절(벡터형). d=입사(면을 향함), n=입사 쪽 바깥 법선, 굴절률 eta1→eta2.
투명체를 통과하는 광선의 굴절을 엄밀하게. 전반사(TIR)면 None. 유리/렌즈/수중의 상 왜곡 계산에. 계약은 단일 벡터. (N,3) 배치도 통과하지만 1 개라도 TIR이면 배치 전체가 None (per-ray 마스크는 하지 않는다). ★배치라면 1 개씩 돌리지 말고 glassmirror.refract_rays를 쓸 것 —— 그쪽은 광선마다 TIR을 판정하여 (방향, TIR 마스크)를 반환한다(TIR인 광선은 경면 반사로 메운다). 이 함수는 "1 개라도 빠지면 답을 내지 않는" fail-closed 쪽의 입구로 남겨 두었다.
d, n은 마지막 축을 벡터로 하여 단위화한다. n은 입사 측(d·n < 0이 되는 방향)으로넘길 것. 반대 방향으로 넘기면 cos θi가 음이 되어 예외 없이 틀린 방향이 반환된다. 반환값은 단위 벡터(eta·d + (eta·cosθi − cosθt)·n, eta = eta1/eta2). eta1 == eta2이면 d가 그대로반환된다. 각도로 다루려면 snell_angle, 반사율은 fresnel_reflectance(cos_i, eta1, eta2).
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• snell_refraction — py -3.11 examples_3d/snell_refraction.py
normals 를 입력으로 받는 것)icp_point2plane · compute_fpfh · shot_descriptor · fuse_to_voxel · reflect · normal_consistency · ransac_cylinder · orient_normals
optics)reflect · fresnel_reflectance · normal_from_reflection · snell_angle
*Provenance: match3d.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.