potential_flow_cylinder — DRIVE swarmflow op

• Datenarten: signal × signal × any → table

• Aufruf: import fullseye as fs; fs.ledger.potential_flow_cylinder(x, y, cylinder, speed: 'float' = 1.0, grid: 'bool' = False) -> 'dict' (die Implementierung direkt: import swarmflow; swarmflow.potential_flow_cylinder(x, y, cylinder, speed: 'float' = 1.0, grid: 'bool' = False) -> 'dict'; aus dem Register: opsdrive.get("potential_flow_cylinder"))

Verwendung

Potentialströmung um einen Zylinder (geschlossene Form). u − i v = U (1 − R²/(z − z_c)²), innerhalb des Kreises NaN.

Bei grid=True werden x/y als Gitterachsen (1-D, Zeilen in y-Reihenfolge) behandelt, und ein Geschwindigkeitsfeld-dict (Modulkonvention) wird zurückgegeben. Der Standard grid=False gibt u, v, inside elementweise zurück (auf dieselbe Form gebroadcastet) —— es wird nicht anhand der Form geraten, ob Achsen oder eine Punktliste vorliegen (1-D x und y gleicher Länge lassen sich auf beide Arten lesen, und eine Punktliste würde stillschweigend zum Gitter). Beide fügen stagnation (den stromaufwärtigen Staupunkt (x_c − R, y_c)), rear_stagnation und surface_speed_max (= 2U) hinzu.

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 · velocity_deficit_map · stagnation_from_centerline


*Provenance: swarmflow.py — DRIVE Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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