swarmflow op• 資料種類:signal × scalar × scalar → table
• 呼叫: import fullseye as fs; fs.ledger.ritter_dam_break(x, t: 'float', h0: 'float', g: 'float' = 9.81, particle_mass=None) -> 'dict'(要直接呼叫實作,import swarmflow; swarmflow.ritter_dam_break(x, t: 'float', h0: 'float', g: 'float' = 9.81, particle_mass=None) -> 'dict';從台帳取用則 opsdrive.get("ritter_dam_break"))
Ritter 潰壩解(淺水方程式，乾河床，壩位於 x = 0，水位於 x < 0)。
c₀ = √(g h₀)。x ≤ −c₀ t: h = h₀、u = 0 / −c₀ t < x < 2c₀ t: h = (2c₀ − x/t)²/(9g)、u = (2/3)(x/t + c₀) / x ≥ 2c₀ t: h = 0。
前緣附近 h ∝ (x_f − x)²,幾乎沒有水。從前緣到 δ 的水量為 ∫₀^δ (s/t)²/(9g) ds = δ³/(27 g t²)(推導)。給定每個粒子的量 m(一維 SPH 則為 h₀Δx),則將 最前方粒子的位置(距前緣量為 m/2 處) x_f − (27 g t² m/2)^{1/3} 回傳到 lead_particle —— 粒子法的前緣看起來必然落後於 Ritter 的前緣,其落後量可由此式讀出(將粒子加密也只按 m^{1/3} 縮小)。
Returns:
dict: h、u(與 x 同形)、front = 2c₀ t、rarefaction_head = −c₀ t、c0、lead_particle(給定 m 時)。
空輸入(x 為 0 個元素)會引發 ValueError。
• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。
• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。
• 演算法的正典(作者、年份)與用途見上面的族使用指南。
• poc_swarm_obstacle_from_flow — py -3.11 examples/poc_swarm_obstacle_from_flow.py
table 作為輸入)course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same
swarmflow)sph_kernel · sph_density_pressure · swarm_simulate · swarm_render_overhead · swarm_field_from_tracks · swarm_field_from_piv · potential_flow_cylinder · velocity_deficit_map
*Provenance: swarmflow.py — DRIVE 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.