normals_to_angles — REPRCONV direction op

• 資料種類:normals → pairs

• 呼叫: import fullseye as fs; fs.ledger.normals_to_angles(normals)(要直接呼叫實作,import reprconv; reprconv.normals_to_angles(normals);從台帳取用則 opsreprconv.get("normals_to_angles"))

用法

法線 (N,3) → 方位・仰角對 (N,2) [度]。normals 的出口。

以 az = atan2(c1, c0) 為軸0-軸1 平面內的方位角,el = asin(c2/|v|) 為從軸2 起的仰角。不用 x/y/z 而用「軸0/1/2」來定義,是因為本 repo 中(z,y,x) 順序的點雲與 (x,y,z) 順序的點雲同時存在 —— 若以名稱來寫,含義就會隨傳入的陣列屬於哪種流派而改變。

可逆: 與 angles_to_normals 往返時方向嚴格復原(實測 max|Δ| = 6.1e-16,selftest 每次都測)。不能復原的只有長度 —— 法線是方向,所以傳入非單位向量時往返後會變成單位向量。

Args:

normals: (N, 3) 實數陣列。零向量被拒絕(方位角無法定義)。

Returns:

(N, 2) float64。行 0 = 方位角 (-180, 180],行 1 = 仰角 [-90, 90]。

Raises:

ValueError: 形狀不是 (N,3) / 非有限 / 含長度為 0 的向量。

參考(範例資料、文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• poc_tacscalib_sphere_lut — py -3.11 examples/poc_tacscalib_sphere_lut.py

• representation_roundtrip — py -3.11 examples/representation_roundtrip.py

型別可銜接的下一個運算子(可接受 pairs 作為輸入)

angles_to_normals · shape_index_to_curvature · pairs_to_signal · pairs_to_image2d · pairs_to_table · polar_to_cscalar

同類別(direction)

angles_to_normals · normals_to_egi

*Provenance: reprconv.py — REPRCONV 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

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