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²)(유도). 입자 1 개의 양 m(1 차원 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 를 발생시킨다.
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL 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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.