piv_synth_sequence — PIV synth op

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

호출: import pivops; pivops.piv_synth_sequence(shape, displacement, n_frames=8, density=0.02, diameter_px=2.5, seed=0, noise_sigma=0.0, intensity=(0.6, 1.0), background=0.0, jitter=0.0)(또는 opspiv.get("piv_synth_sequence"))

사용법

> 이 연산자의 설명은 아직 번역이 없습니다. 원문을 그대로 싣습니다.

同じ粒子を繰り返し動かした画像列。返りは `(frames, truth)`。

:func:piv_synth_pair が 2 枚なのに対し、こちらは **1 つの流れを追い続けた

列**を作る。アンサンブル相関と時間統計はこれでないと確かめられない ——

独立な対を並べたものを列と呼ぶと、隣り合う 2 枚に対応関係が無く、

統計が無意味になる(実測: 平均 0.73 px に対して変動の RMS が 4.05 px という、

流れではなく作り方を測った数字が出た)。

Args:

shape: `(H, W)`。

displacement: 1 コマあたりの変位(:func:piv_synth_pair と同じ形式)。

n_frames: コマ数(2 以上)。

jitter: コマごとに場全体へ加える乱れの標準偏差 [px]。0 なら定常流。

時間統計(変動・レイノルズ応力)を試すにはここを 0 より大きくする。

★ 粒子ごとに独立な乱れではなくコマごとに一つの乱れにしてある。

粒子ごとに振ると、窓の中で平均されて N の平方根ぶん小さくなり、

仕込んだ値と測った値が合わない(実測: 仕込み 0.3 に対して 0.15)。

それは PIV の性質であって間違いではないが、**時間統計の検証には

使えない**ので、ここは非定常な流れそのものを模す形にした。

density / diameter_px / seed / noise_sigma / intensity / background:

:func:piv_synth_pair と同じ。

Returns:

`(frames: list of (H, W), truth: (2, H, W))truth` は

1 コマあたりの平均変位。

자세한 사용 가이드

piv_displacement 패밀리 가이드

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

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

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

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

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

• (아직 없음)

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

piv_ensemble_correlate · piv_time_statistics

같은 카테고리(synth)

piv_synth_particles · piv_synth_pair


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

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