synth op• 데이터 종류: 없음 → image2d(인자만으로 정해지는 연산자 —— 이미지나 데이터 입력을 받지 않습니다)
• 호출: import fullseye as fs; fs.ledger.piv_synth_pair(shape, displacement, density=0.02, diameter_px=2.5, seed=0, noise_sigma=0.0, intensity=(0.6, 1.0), background=0.0)(구현을 직접 호출하려면 import pivops; pivops.piv_synth_pair(shape, displacement, density=0.02, diameter_px=2.5, seed=0, noise_sigma=0.0, intensity=(0.6, 1.0), background=0.0), 원장에서 가져오려면 opspiv.get("piv_synth_pair"))
• 원장 경유의 반환값: fullseye.ledger.piv_synth_pair(...) 는 선언된 out 형 image2d 의 값만 반환합니다(실제 함수는 보조 정보도 반환). 버려진 쪽이 필요하면 fullseye.ledger.piv_synth_pair.raw(...) 를 쓰거나 pivops.piv_synth_pair 를 직접 호출하세요.
• 실제 반환: (a, b, truth) -> image2d
알려진 변위장을 가진 영상 쌍을 만든다. 반환값은 (image_a, image_b, truth).
입자를 움직인 뒤 2번째 장을 그린다(1번째 장을 보간으로 왜곡하는 것이 아니다). 보간으로 만들면 보간의 평활화가 "PIV가 맞히기 쉬운 그림"을 만들어 버려, 자신의 구현을 자신에게 유리한 입력으로 재는 셈이 된다.
Args:
shape: (H, W).
displacement: 변위를 주는 방법. 다음 중 하나.
• 길이 2의 열 —— 균일 병진 (dy, dx) [px].
• callable(rows, cols) -> (dy, dx) —— 위치에 의존하는 장. 인수는 입자의 연속 좌표 배열.
density / diameter_px / seed / intensity / background: piv_synth_particles와 같다.
noise_sigma: 2장 각각에 독립적으로 더하는 가법 가우스 잡음의 표준편차.
Returns:
(a (H, W), b (H, W), truth (2, H, W)). truth는 화소별
참 변위이며, 창의 격자에 떨어뜨리려면 piv_sample_at_windows를 사용한다.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.
• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.
• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.
• piv_field_analysis_tour — py -3.11 examples/piv_field_analysis_tour.py
• piv_flow_from_particles — py -3.11 examples/piv_flow_from_particles.py
• poc_strain_history — py -3.11 examples/poc_strain_history.py
image2d 를 입력으로 받는 것)piv_cross_correlate · piv_multipass · piv_deform_pass · strain_from_displacement · correlation_quality · speckle_quality
synth)piv_synth_particles · piv_synth_sequence
*Provenance: pivops.py — PIV 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.