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 인 벡터를 포함한다.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL 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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.