piv_streamlines — PIV `visualise` op

• 数据种类:flow2d → table

• 调用: import fullseye as fs; fs.ledger.piv_streamlines(flow, seeds=None, separation=None, step=0.25, max_length=None, min_speed=0.001, test_ratio=0.5)(要直接调用实现,import pivops; pivops.piv_streamlines(flow, seeds=None, separation=None, step=0.25, max_length=None, min_speed=0.001, test_ratio=0.5);从台账取用则 opspiv.get("piv_streamlines"))

用法

用 RK4 追踪流线(相当于 MATLAB 的 stream2 / streamslice)。

省略 seeds 时，用 Jobard–Lefer(1997)的等间距配置自动放置种子。流线彼此以约 separation 的间隔排列，在比 test_ratio * separation 更近处截断。箭头图画密了会挤成一团，手动放种子会留下空白，而这种配置既不产生空白也不产生重叠(以下面 2 个性质作为门禁)。

• 不同流线的采样点之间不会比 test_ratio * separation 更近。

• 速度在 min_speed 以上的任何网格点，都在某条流线的 separation 以内(没有遗漏)。

坐标是 flow 的网格(行 0 在上，(row, col))。方向场除以速度后 按弧长前进，因此 1 步为 step 个网格。速度在流线上各点另行返回。

Args:

flow: (2, h, w)(dy, dx)。

seeds: (n, 2) 的 (row, col)。None 为自动配置。

separation: 流线的间隔 [网格]。None 为 max(h, w) / 25(2 以上)。

step: RK4 的 1 步 [网格]。

max_length: 单方向的最大长度 [网格]。None 为 4 * (h + w)。

min_speed: 比这更慢的地方停止(相对最大速度的比值)。

test_ratio: 截断距离取 separation 的几倍(0 < x ≤ 1)。

Returns:

dict(table)：paths((m_i, 2) 的 list，上游 → 下游的顺序)、

speed(各点速度的 list)、seeds、stop((后, 前) 的

理由组的 list)、n、separation、d_test、step、

stop_counts(各理由的数量)。

Raises:

ValueError: flow 的形状、非有限、参数超出范围、种子在网格之外。

详细使用指南

• piv_displacement 族使用指南

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者、年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• piv_field_analysis_tour — py -3.11 examples/piv_field_analysis_tour.py

类型可衔接的下一个算子(可接受 `table` 作为输入)

—

同类别(`visualise`)

piv_flow_to_rgbimage · piv_line_integral_convolution · piv_quiver · piv_streamline_image

*Provenance: pivops.py — PIV 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

piv_streamlines — PIV visualise op

用法