synthesize_fringes — 3D `structured_light` op

• 데이터 종류: image2d → images

• 호출: import fullseye as fs; fs.ledger.synthesize_fringes(height, n_steps=4, freq=1.0, phase_gain=1.0, bias=0.5, amplitude=0.5, axis=1, noise=0.0, seed=None, return_phase=False)(구현을 직접 호출하려면 import fringe; fringe.synthesize_fringes(height, n_steps=4, freq=1.0, phase_gain=1.0, bias=0.5, amplitude=0.5, axis=1, noise=0.0, seed=None, return_phase=False), 원장에서 가져오려면 ops3d.get("synthesize_fringes"))

• 원장 경유의 반환값: fullseye.ledger.synthesize_fringes(...) 는 선언된 out 형 images 의 값만 반환합니다(실제 함수는 보조 정보도 반환). 버려진 쪽이 필요하면 fullseye.ledger.synthesize_fringes.raw(...) 를 쓰거나 fringe.synthesize_fringes 를 직접 호출하세요.

사용법

알려진 height map 으로부터 N-step 위상 이동 프린지 이미지 열을 합성합니다(테스트/샘플 생성용).

모델: 총 위상 φ(x,y) = φ_carrier + phase_gain·height. 반송파 φ_carrier는 시야를 가로지르는 선형램프(freq 주기). 각 프레임은 I_n = bias + amplitude·cos(φ - δ_n), δ_n = 2πn/N. 이 부호 규약에 의해 wrapped_phase(...)는 총 위상 φ를 그대로 복원한다.

height: 2D 배열(계측 대상의 높이장, 임의 단위).

n_steps: 위상 시프트 장수 N(>=3).

freq: 시야 폭을 가로지르는 반송파의 주기 수(줄무늬 개수). 0이면 반송파 없음(height만).

phase_gain: 높이→위상의 변환 게인(rad/단위). 복호 측의 캘리브레이션 k = 1/phase_gain에 대응.

bias: 평균 휘도 a(기본값 0.5).

amplitude: 줄무늬 진폭 b(기본값 0.5). bias±amplitude가 [0,1]에 들어가면 자연스럽다.

axis: 반송파의 방향(1 = 열 방향 x를 따르는 기본값, 0 = 행 방향 y).

noise: 부가 가우스 잡음의 표준편차(0이면 무잡음).

seed: 잡음용 난수 시드.

return_phase: True이면 (images, total_phase)를 반환한다(테스트·디버그용).

반환값: (N, H, W) float 배열(값 범위 [0,1]로 클립). return_phase=True이면 위상도.

배경 지식 가이드(이 연산자 앞에 있는 물리·규약)

• depth_sensors — 깊이 센서 지식 — 측거 원리·실기 수치·결측이 나타나는 방식

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

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

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

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

• structured_light — py -3.11 examples_3d/structured_light.py

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

fuse_to_voxel · photometric_stereo · wrapped_phase · graycode_decode · decode_fringe · carve · visual_hull

같은 카테고리(`structured_light`)

wrapped_phase · unwrap_phase_2d · graycode_decode · decode_fringe · absolute_phase · triangulate_column

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

synthesize_fringes — 3D structured_light op

사용법