refract — 3D optics op

Datenarten: vector × normalsnormals

Aufruf: import fullseye as fs; fs.ledger.refract(d, n, eta1=1.0, eta2=1.5) (die Implementierung direkt: import match3d; match3d.refract(d, n, eta1=1.0, eta2=1.5); aus dem Register: ops3d.get("refract"))

Verwendung

Snellius-Brechung (Vektorform). d = einfallender Strahl (zur Fläche hin), n = äußere Normale auf der Einfallsseite, Indizes eta1 → eta2.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

透明体を通る光線の曲がりを厳密に。全反射(TIR)なら None。ガラス/レンズ/水中の像歪み計算に。

契約は単一ベクトル。(N,3) バッチも通るが、1 本でも TIR ならバッチ全体が None

(per-ray マスクはしない)。★バッチなら 1 本ずつ回すのではなく

:func:glassmirror.refract_rays を使うこと —— あちらは光線ごとに TIR を判定して

`(方向, TIR マスク)` を返す(TIR の光線は鏡面反射で埋める)。この関数は

「1 本でも欠けたら答えを出さない」fail-closed 側の口として残してある。

`d, n は最後の軸をベクトルとして単位化する。n は入射側(d·n < 0` になる向き)で

渡すこと。逆向きに渡すと `cos θi` が負になり、例外なく誤った方向が返る。返り値は単位ベクトル

(`eta·d + (eta·cosθi − cosθt)·neta = eta1/eta2)。eta1 == eta2 なら d` がそのまま

返る。角度で扱うなら `snell_angle、反射率は fresnel_reflectance(cos_i, eta1, eta2)`。

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

snell_refractionpy -3.11 examples_3d/snell_refraction.py

Typkompatible Folge-Operatoren (nehmen normals als Eingabe)

icp_point2plane · compute_fpfh · shot_descriptor · fuse_to_voxel · reflect · normal_consistency · ransac_cylinder · orient_normals

Gleiche Kategorie (optics)

reflect · fresnel_reflectance · normal_from_reflection · snell_angle


*Provenance: match3d.py — 3D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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