piv_synth_particles — PIV `synth` op

• 데이터 종류: 없음 → image2d(인자만으로 정해지는 연산자 —— 이미지나 데이터 입력을 받지 않습니다)

• 호출: import fullseye as fs; fs.ledger.piv_synth_particles(shape, density=0.02, diameter_px=2.5, seed=0, intensity=(0.6, 1.0), background=0.0)(구현을 직접 호출하려면 import pivops; pivops.piv_synth_particles(shape, density=0.02, diameter_px=2.5, seed=0, intensity=(0.6, 1.0), background=0.0), 원장에서 가져오려면 opspiv.get("piv_synth_particles"))

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

• 실제 반환: (image, positions) -> image2d

사용법

트레이서 입자를 뿌린 영상 1장을 만든다. 반환값은 (image, positions).

입자는 가우스 휘점(직경 = 1/e^2 폭이 아니라 표준편차의 2배를 diameter_px라고 부르는 PIV의 관행). 위치는 연속값이므로 서브픽셀의참값을 가진 이미지를 만들 수 있다.

density는 1 화소당 입자 수. PIV의 경험칙으로는 창당 5-10개가기준이며, 32x32 창이라면 0.005-0.01에 해당한다. 너무 적으면 상관 피크가 서지 않고, 너무 많으면 입자상이 겹쳐 개개의 대응이 사라진다.

Args:

shape: (H, W).

density: 화소당 입자 수(> 0).

diameter_px: 입자상의 직경 [px] (> 0).

seed: 난수 시드.

intensity: 입자 밝기의 범위 (lo, hi).

background: 균일한 바닥값.

Returns:

(image (H, W) float64, positions (N, 2)의 (row, col)).

자세한 사용 가이드

• piv_displacement 패밀리 가이드

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

• 샘플 데이터 카탈로그(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

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

piv_cross_correlate · piv_multipass · piv_deform_pass · strain_from_displacement · correlation_quality · speckle_quality

같은 카테고리(`synth`)

piv_synth_pair · piv_synth_sequence

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

piv_synth_particles — PIV synth op

사용법