ritter_dam_break — DRIVE `swarmflow` op

• Datenarten: signal × scalar × scalar → table

• Aufruf: import fullseye as fs; fs.ledger.ritter_dam_break(x, t: 'float', h0: 'float', g: 'float' = 9.81, particle_mass=None) -> 'dict' (die Implementierung direkt: import swarmflow; swarmflow.ritter_dam_break(x, t: 'float', h0: 'float', g: 'float' = 9.81, particle_mass=None) -> 'dict'; aus dem Register: opsdrive.get("ritter_dam_break"))

Verwendung

Rittersche Dammbruchlösung (Flachwassergleichungen, trockenes Bett, Damm bei x = 0, Wasser bei 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.

Nahe der Front gilt h ∝ (x_f − x)², es ist also kaum Wasser vorhanden. Die Wassermenge von der Front bis δ ist ∫₀^δ (s/t)²/(9g) ds = δ³/(27 g t²) (hergeleitet). Wird die Menge pro Partikel m angegeben (h₀Δx bei 1-D-SPH), wird der Ort des vordersten Partikels (wo die Menge ab der Front m/2 ist) x_f − (27 g t² m/2)^{1/3} in lead_particle zurückgegeben —— die Front eines Partikelverfahrens erscheint stets hinter der Ritter-Front, und der Rückstand lässt sich aus dieser Formel ablesen (feinere Partikel verkleinern ihn nur mit m^{1/3}).

Returns:

dict: h, u (gleiche Form wie x), front = 2c₀ t, rarefaction_head = −c₀ t, c0, lead_particle (wenn m angegeben).

Leere Eingabe (x mit 0 Elementen) löst ValueError aus.

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_swarm_obstacle_from_flow — py -3.11 examples/poc_swarm_obstacle_from_flow.py

Typkompatible Folge-Operatoren (nehmen `table` als Eingabe)

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

Gleiche Kategorie (`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 Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

ritter_dam_break — DRIVE swarmflow op