sph_kernel — DRIVE `swarmflow` op

• Datenarten: signal × scalar → signal

• Aufruf: import fullseye as fs; fs.ledger.sph_kernel(r, h: 'float', dim: 'int' = 2, derivative: 'bool' = False) -> 'np.ndarray' (die Implementierung direkt: import swarmflow; swarmflow.sph_kernel(r, h: 'float', dim: 'int' = 2, derivative: 'bool' = False) -> 'np.ndarray'; aus dem Register: opsdrive.get("sph_kernel"))

Verwendung

Kubischer Spline-Kern (3. Ordnung) W(r, h) (M4, Trägerradius 2h). Mit derivative=True dW/dr (Ableitung in r-Richtung, ≤ 0).

W = σ_d [1 − 1.5 q² + 0.75 q³] (0 ≤ q < 1), σ_d · 0.25 (2 − q)³ (1 ≤ q < 2), 0 (q ≥ 2), q = r/h. σ_1 = 2/(3h), σ_2 = 10/(7π h²), σ_3 = 1/(π h³). Mit diesen Konstanten gilt ∫ W dV = 1 (Identität; per Gate mit numerischer Quadratur verglichen).

Args:

r: Array von Abständen (≥ 0, beliebige Form).

h: Glättungslänge (> 0).

dim: 1, 2, 3.

derivative: bei True wird dW/dr zurückgegeben.

Returns:

Array derselben Form wie r.

Raises:

ValueError: h ≤ 0, dim nicht in 1 bis 3, r enthält negative oder nicht-endliche Werte.

Leere Eingabe (r 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 `signal` als Eingabe)

flight_vacuum · magnus_lift_coefficient · drag_coefficient_sphere · restitution_from_apexes · restitution_from_intervals · fit_parabola · flight_fit · fit_aero

Gleiche Kategorie (`swarmflow`)

sph_density_pressure · swarm_simulate · swarm_render_overhead · swarm_field_from_tracks · swarm_field_from_piv · potential_flow_cylinder · 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).*

sph_kernel — DRIVE swarmflow op