piv_velocity_gradient — PIV field op

• 데이터 종류: flow2d → table

• 호출: import fullseye as fs; fs.ledger.piv_velocity_gradient(flow, spacing=1.0)(구현을 직접 호출하려면 import pivops; pivops.piv_velocity_gradient(flow, spacing=1.0), 원장에서 가져오려면 opspiv.get("piv_velocity_gradient"))

• GPU: 없음(CPU 참조 구현만)

사용법

속도 구배 텐서의 성분과 그로부터 나오는 양을 함께 반환한다.

와도·발산·Q 기준·와류 회전 강도·변형률 속도는 모두 같은 4개의 미분에서나오므로, 기울기를 4번 다시 계산하지 않아도 되도록 여기에 모은다. 개별 op (piv_vorticity 등)는 단독으로도 쓸 수 있지만, 여러 개가 필요하면 이쪽.

Returns:

dict: dudx / dudy / dvdx / dvdy(각 (h, w)),

vorticity / divergence / q / swirl / strain_rate,

spacing.

자세한 사용 가이드

• 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

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

—

같은 카테고리(field)

piv_vorticity · piv_divergence · piv_flow_magnitude · piv_to_velocity · piv_q_criterion · piv_swirling_strength · piv_strain_rate


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

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