Stationäre hydraulisch-thermische Berechnung von HVAC-Hydraulikschaltungen (Heizung/Kühlung) als generisches 1D-Netzwerk. Inkompressibles Fluid mit konstanten Stoffwerten (ρ, μ, cp); SIMPLE-artiger Druckkorrektur-Solver plus sequentiell gelöste Energiegleichung — mit zwei grafischen Schema-Editoren (Hydraulik und Lüftung/VKA) inklusive integriertem Solver: Rechnen direkt im GUI, Ergebnisse per Mouse-Over in der Zeichnung.
Maschinenlesbare Strangschemas für KI-Agenten: Strangschemas sind für KI-Agenten bislang schwer zugänglich, weil ihre Vision-Fähigkeiten für das zuverlässige Interpretieren von Anlagenschemata nicht ausreichen. Dieses Tool löst das Eingabeproblem konstruktiv: Das Schema wird im Editor gezeichnet und liegt damit von Anfang an maschinenlesbar als YAML vor — die Zeichnung ist das Modell, es gibt keinen Interpretationsschritt. Über den integrierten Solver (▶ Rechnen) wird die Eingabe per Human in the Loop geprüft (Volumenströme, Drücke, Temperaturen direkt im Schema), bevor ein KI-Agent das validierte YAML für Analyse- und Optimierungsstudien übernimmt. Das Paket dient zugleich der Entwicklung von Benchmark-Tests für KI-Agenten in der technischen Gebäudeausrüstung.
git clone https://github.com/AI4Buildings/HVAC-Hydronic-Network-Solver.git
cd HVAC-Hydronic-Network-Solver
pip install -e ".[dev]"
pytest # 263 Tests (analytische Referenzen + Validierung gegen Musterlösungen)editor server # startet beide Editoren: http://127.0.0.1:8091/Die Startseite verlinkt den Hydraulikschema-Editor (/hydraulik) und den
Lüftungsschema-Editor (/lueftung); gerechnet wird direkt im GUI
(lokaler Endpunkt, nur 127.0.0.1). editor serve, kurz editor oder das
ältere hydraulik serve tun dasselbe; --port/--no-open optional.
Daneben gibt es das CLI hydraulik (run = YAML rechnen, editor =
statische HTML-Datei erzeugen, serve).
hydraulik run examples/04_heatpump_separator.yamloder in Python:
import hydraulik as h
net = h.Network(fluid=h.water_at(45))
net.add(h.HeatPump("wp1", mode="target_t_out", t_out_set_C=45, q_max_kW=12, q_nom_m3h=1.4))
net.add(h.Pump("pu1", mode="constant_flow", q_m3h=1.4))
net.add(h.Radiator("hk1", q_nom_kW=7.5, t_sup_nom_C=45, t_ret_nom_C=40, t_room_C=21))
net.connect("wp1.out", "pu1.in")
net.connect("pu1.out", "hk1.in")
net.connect("hk1.out", "wp1.in")
result = net.solve()
print(result.report())
print(result["hk1"].q_dot_kW) # Wärmestrom ins Wasser [kW]editor server # Editor MIT Rechen-Endpunkt (empfohlen)
hydraulik editor --out hydraulik_editor.html # nur Zeichnen (statische Datei)Workflow: Schaltung zeichnen → ▶ Rechnen direkt im GUI (lokaler Endpunkt POST /solve, nur 127.0.0.1) → Ergebnisse erscheinen in der Zeichnung: Wertezeile unter jeder Komponente (V̇, T ein→aus) und Mouse-Over-Tooltips (Komponenten: V̇, Δp, T, Q̇, v; Leitungen/Ports: Knotendruck in kPa(ü) und Temperatur) → prüfen, korrigieren, neu rechnen (jede Änderung verwirft die Ergebnisse automatisch) → YAML als Datei exportieren → Analyse-/Optimierungsstudien mit dem Solver skripten (z.B. durch einen Coding-Agenten — der das Anlagenschema dann nicht mehr aus Abbildungen interpretieren muss, sondern das validierte YAML erhält).
Eigenständige HTML-Datei (kein Server, keine Internetverbindung): Komponenten
aus der Palette platzieren; jede gezogene Linie ist eine
Verbindungsleitung (conduit): standardmäßig ideal, per Inspector
wahlweise C-Wert, Auslegungspunkt (dp + q) oder Rohrmodell (length +
d_inner …, inkl. Wärmeverlust) — mit eigenem Namen (sichtbar bei
Selektion), ts-Label und eigenen Ergebniswerten im Hover (V̇, Δp, T, v).
Leitungsführung mit Knickpunkten (Doppelklick auf Leitung setzt eine
Umlenkung, Griffe ziehen, Doppelklick auf Griff entfernt; ohne Knick
automatisch gerade bzw. abgewinkelt), Vorlagen für Standardschaltungen
(Palette-Register „Vorlagen“: mitgeliefert sind die sieben Grundschaltungen
Beimischschaltung einfach/doppelt/doppelt-differenzdruckarm, Drossel-,
Umlenk- sowie Einspritzschaltung mit Durchgangs- bzw. Dreiwegeventil;
eigene Vorlagen: Bereich auswählen → „Als Vorlage speichern" → per Klick
platzieren und Parameter anpassen; im Browser gespeichert, als JSON-Datei
export-/importierbar zum Teilen), Mehrfachauswahl
(Auswahlrechteck aufziehen oder Shift+Klick) mit gemeinsamem Verschieben und
Kopieren/Einfügen ganzer Teilschaltungen (Strg+C/V/D — interne Leitungen
werden mitkopiert, Namen automatisch hochgezählt), Undo/Redo
(Strg+Z / Strg+Shift+Z oder ↶/↷), Zoom (Strg+Mausrad an der
Cursorposition oder −/+/1:1-Buttons, 25–300 %, Zeichenfläche wächst automatisch mit),
Drehen in 90°-Schritten (Taste r —
Ports rotieren mit), Parameter im Inspector (mit Einheitenwahl und
Bereichsanzeige), Leitungsfarben Heizung (VL rot / RL blau) und Kälte
(VL hellgrün / RL dunkelgrün), ts-Labels, Live-Prüfliste (unverbundene
Ports, fehlende Pflichtparameter, Wertebereiche; klicken wählt die
betroffene Komponente aus). Export erzeugt direkt
rechenbares YAML inkl. layout:-Block (Zeichnungskoordinaten) für den
Re-Import — die Zeichnung ist damit das Modell, es gibt keinen
Interpretationsschritt. Der Import akzeptiert unter editor server jede
YAML-Form (Block- oder Inline-Stil; PyYAML auf dem Server, doppelte
Schlüssel werden gemeldet, Loader-Hinweise erscheinen in der Statuszeile);
die statische HTML-Datei liest das Inline-Exportformat. Palette, Ports und Formulare werden aus der
Komponenten-Registry generiert (Single Source of Truth): Nach neuen
Komponenten einfach den Editor neu erzeugen.
fluid: {preset: water, t_C: 45} # oder {rho: 998, mu: 1.0e-3, cp: 4180}
settings: {max_iter: 400} # optional (siehe SolverSettings)
components:
wp1: {type: heat_pump, mode: target_t_out, t_out_set_C: 45, q_max_kW: 12, q_nom_m3h: 1.4}
pu1: {type: pump, mode: constant_flow, q_m3h: 1.4}
hk1: {type: radiator, q_nom_kW: 7.5, t_sup_nom_C: 45, t_ret_nom_C: 40, t_room_C: 21}
connections: # 'komponente.port'; ≥3 Einträge = Verzweigung
- [wp1.out, pu1.in]
- [pu1.out, hk1.in]
- [hk1.out, wp1.in]Regeln:
- Einheiten über Suffixe:
dp_kPa/dp_Pa/dp_bar,q_m3h/q_l_s/q_m3s,t_..._C,..._kW/..._W,length_m/..._mm,kvs_m3h,ua_W_K,u_linear_W_mK,k_W_m2K,m_dot_air_kg_s. Intern strikt SI. - Jeder Port muss in mindestens einer Verbindung vorkommen. Ein Port in mehreren Verbindungen (oder ≥3 Ports je Eintrag) bildet eine ideale Mischstelle (Verzweigung).
- Validierungsfehler werden gesammelt als nummerierte Liste gemeldet (mit Korrekturvorschlägen), sodass eine Datei in einem Durchgang korrigierbar ist.
Zweites GUI unter editor server → http://127.0.0.1:8091/lueftung (Hydraulik: /hydraulik; die Startseite / verlinkt beide):
Lüftungsanlagen als zwei Ketten zeichnen (Zuluft: AUL → … → ZUL oben,
Abluft: ABL → … → FOL unten; die WRG verbindet beide Stränge) und mit dem
integrierten VKA-Rechenkern (energieoptimale Regelung, aus dem Skill
vka-effizienz-en16798) rechnen. Komponenten: WRG (Sorptions-/Enthalpie-/
Kondensationsrotor, KVS, Platte), Frostschutz, Vor-/Nachheizer, Kühler,
Befeuchter (Dampf/Sprüh), Ventilatoren (SFP), Umluft, Filter, Schalldämpfer
und Luft-Sensoren (Kombifühler T+rF, T, rF, Δp, p, V̇, Energiezähler,
Stromzähler — als Anzapfungen mit dünner Messleitung an beliebige
Kanal-Anschlüsse, ohne die Stränge zu berühren; alle mit BEMS-Messpunktlisten).
Nach dem Rechnen zeigen Mouseover-Tooltips auf jeder Kanalleitung den
Luftzustand des Abschnitts (ϑ, φ, x, V̇); Fühler zeigen den Zustand an
ihrer Messstelle. Regelungsart an der Zuluft wählbar:
Zustand fest gepinnt, Sollband oder raumgekoppelt mit
Feuchtelast (simulate_room); der Abluft-Volumenstrom wird praxisgerecht an
der Abluft angegeben (leer = balancierte Anlage). Ergebnisse (Heiz-/Kühl-/
Befeuchterleistung, WRG-Kennwerte, Zuluftzustand, Ventilatorstrom) erscheinen
im Ergebnispanel, als Tooltip und unter jeder Komponente. Drei Vorlagen
liegen bei: Vollklima mit Sorptionsrotor, KVS-Anlage sowie die reale
Anlage „GEA Vollklima Energetikum" (CAIRplus SX 096.064 IVBV) — fertig
parametriert mit dem Winter-Auslegungsfall aus der Gerätedokumentation und
per Regressionstest gegen die Datenblattwerte abgesichert. Die
Ventilatorposition wird rechnerisch am Stranganfang bilanziert (validierte
Modellkonvention); Rotor-Übertragungsgrade sind physikalisch auf ε ≤ 1
begrenzt (Hinweis bei stark unbalancierten Volumenströmen).
Das maschinenlesbare Strangschema ist nicht nur Rechenmodell, sondern auch semantische Karte für die Betriebsdatenanalyse eines Building Energy Management Systems (BEMS, z.B. Aedifion). Die Palette-Rubrik SENSOREN (unterste Gruppe im Register „Komponenten“) stellt dafür Temperatur-, Druck-, Differenzdruck-, Volumenstromsensoren und Wärmemengenzähler bereit:
- Rückwirkungsfrei: Fühler zapfen den Messknoten nur an (Messleitung = dünne Linie, reine Knotenverschmelzung, keine Rohrleitung); V̇-Sensor und WMZ sitzen quasi-ideal in der Leitung. Die Hydraulik bleibt unverändert.
- Mitwachsende Zeichenfläche: das Canvas vergrößert sich automatisch, sobald Komponenten oder Knickpunkte an den Rand rücken (immer ~600 px Reserve hinter dem äußersten Element) — beliebig große Strangschemas ohne Einstellungen; beim Löschen schrumpft es auf die Standardgröße zurück.
- Strömungsrichtung im Bild: nach erfolgreicher Rechnung zeigt jede Verbindungsleitung in ihrer Mitte ein schlankes Richtungsdreieck in Linienfarbe (V̇ ≈ 0 oder zu kurze Stücke bleiben pfeilfrei; bei jeder Änderung verschwinden die Pfeile mit dem Ergebnis).
- Messwerte per Mouseover: nach dem Rechnen zeigt der Tooltip die simulierten
Sensorwerte (ϑ, p, Δp, V̇, WMZ zusätzlich Q̇ aus ṁ·cp·Δϑ) samt BEMS-Zuordnung;
im Python-Ergebnis stehen sie unter
result.sensorsbzw.to_dict()["sensors"]. - BEMS-Datenpunkte (generisch): JEDE Komponente trägt eine frei lange
Messpunktliste
bems: [{id, key, description}, …]—idist die abfragbare Datenpunkt-ID,keyder sprechende Alias (z.B.EXP_HP_SEK_T_VL),descriptiondie Semantik. So bildet ein WMZ seine fünf realen Datenpunkte (V̇, Q̇, Q_kum, ϑ_VL, ϑ_RL) ab, ein Speicher mehrere Fühler, ein Stellventil sein Stellsignal, eine Pumpe Cmd + kWh-Zähler. Zusätzlich hat jede Komponente ein freiesdescription-Feld. Im Editor sind die Eingaben in zwei Register getrennt: Fluid-Info (Simulationsparameter) und BEMS-Info (Beschreibung + Messpunkte, „+ Messpunkt hinzufügen"). - Zweck: Ein LLM, das die YAML-Datei liest, erhält damit beides zugleich — die Netzwerktopologie (wo sitzt der Sensor, was liegt stromauf/-ab) und den Schlüssel zu den realen Zeitreihen. Simulation und Messdaten lassen sich so automatisiert verknüpfen (Soll-Ist-Vergleich, Performance-Gap-Analyse).
type |
Ports | Wichtigste Parameter |
|---|---|---|
pipe |
in, out | length_m, d_inner_mm, roughness_mm, zeta, u_linear_W_mK, t_amb_C |
flow_resistance |
in, out | c_Pa_m3h2 (C-Wert, z.B. aus REGuA) oder c_Pa_m3s2 oder Auslegungspunkt dp_kPa + q_m3h; optional a_Pa_m3h (linearer Anteil). Genau eine Widerstandsangabe. Dichteunabhängig (anders als Kv!) |
pump |
in, out | mode: constant_dp|constant_flow, dp_kPa bzw. q_m3h, q_nom_m3h |
control_valve |
in, out | kvs_m3h, opening (0…1), characteristic: equal_percentage|linear |
balancing_valve |
in, out | kvs_m3h, opening (Voreinstellung) |
ball_valve |
in, out | Kugelhahn (Absperrarmatur): Default offen und druckverlustfrei (1 Pa Referenzverlust bei q_nom_m3h, wie link); optional realer kvs_m3h; closed: true = Revisionsfall, sperrt exakt (V̇ = 0) |
temperature_sensor |
port | Temperaturfühler (Messstelle anzapfen, keine Kante): liest ϑ des Knotens |
pressure_sensor |
port | Drucksensor: liest p (Überdruck) des Knotens |
pressure_diff_sensor |
plus, minus | Differenzdrucksensor: Δp = p(plus) − p(minus), z.B. über Pumpe/Ventil |
flow_sensor |
in, out | Volumenstromsensor in der Leitung (quasi-ideal, 1 Pa bei q_nom_m3h) |
energy_meter |
in, out, t_ref | Wärmemengenzähler: Durchflussteil in der Leitung + Fühler t_ref in der Gegenleitung; misst V̇, beide ϑ und Q̇ = ṁ·cp·(ϑ_ref − ϑ_Leitung) (Einbau im RL → Q̇ > 0 = Kreisabgabe); die 5 realen Datenpunkte als bems-Einträge |
check_valve |
in, out | Rückschlagklappe: kvs_m3h (Durchlassrichtung in→out); sperrt rückwärts (Restleckage kvs/1000, über block_factor einstellbar) |
mixing_valve_3way |
a, b, ab | kvs_m3h, opening (A-Pfad), characteristic |
radiator |
in, out | q_nom_kW, t_sup_nom_C, t_ret_nom_C, t_room_C, n, q_prescribed_kW; Hydraulik: kv_m3h ODER c_Pa_m3h2 (Default 10 kPa bei Nennstrom) |
floor_heating |
in, out | area_m2, k_W_m2K, t_room_C; Hydraulik: length_m (+ d_inner_mm, Rohrmodell) ODER c_Pa_m3h2 |
heating_coil / cooling_coil |
in, out | ε-NTU mit Teillast-UA nach Gl. 4.2 (ua_ref_W_K, n Default 0.4, Referenzen q_w_ref_m3h/m_dot_air_ref_kg_s; ohne Referenzen UA konstant); m_dot_air_kg_s, t_air_in_C, arrangement; ODER feste Leistung q_prescribed_kW (dann kein UA nötig); Hydraulik: kv_m3h ODER c_Pa_m3h2. Kühlregister zusätzlich Greybox MIT Kondensation: ua_star_wet_kg_s + rh_air_in (0…1) → Q̇ = max(trocken, nass), Kondensatrate/Luftaustritt in extras |
heat_pump / chiller |
in, out | mode: prescribed_q|target_t_out, q_dot_kW bzw. t_out_set_C + q_max_kW, dp_nom_kPa, q_nom_m3h |
buffer_storage |
p1…pN | n_ports, ua_W_K, t_amb_C (ideal durchmischt) |
inflow (Zulauf) |
port | t_set_C + ENTWEDER q_m3h (Zulauf-V̇) ODER p_kPa (Überdruck gauge) |
outflow (Austritt) |
port | ENTWEDER p_kPa (Überdruck gauge; Auslauf ins Freie: 0) ODER q_m3h (Entnahme-V̇); Austrittstemperatur ist Ergebnis |
ideal_storage |
in, out | t_set_C (Vorlauf fest; Rücklauf und Leistung sind Ergebnis); optional q_m3h (eingeprägter Volumenstrom, Δp ist Ergebnis) und/oder p_out_kPa (Überdruck am Austritt = Druckanker); dp_nom_kPa + q_nom_m3h |
conduit (Verbindungsleitung) |
in, out | universelle Leitung (im Editor als Linie): ohne Angabe ideal; c_Pa_m3h2 ODER dp_kPa+q_m3h ODER Rohrmodell — ein Abschnitt via length_m (+ d_inner_mm, …) ODER beliebig viele Abschnitte in Reihe via pipes: [{length_m, d_inner_mm, roughness_mm, zeta}, …] (im Editor: Abschnittsliste mit +/−); Wärmeverlust u_linear_W_mK/t_amb_C über die Gesamtlänge |
link |
in, out | q_nom_m3h. Widerstandsfreie Verbindung (Δp ≈ 1 Pa), die zwei Knoten thermisch trennt — für Anschlüsse entlang eines Sammlers, damit Zapfstellen nicht stromab eingemischtes Wasser „sehen" |
hydraulic_separator |
prim_in, prim_out, sec_in, sec_out | q_nom_m3h, dp_nom_Pa, ua_W_K |
manifold |
main, s1…sN | n_ports |
tee |
a, b, c | T-Stück 90° (a–b gerader Strang, c Abzweig): Default idealer Knoten; mit d_run_mm + d_branch_mm Druckverlust nach Idelchik (Diagramme 7-10/7-21, ζ = f(V̇-Verhältnis, Flächenverhältnis), Vereinigung UND Trennung automatisch aus der Strömungsrichtung, inkl. Bernoulli-Umrechnung auf statische Drücke) |
open_end |
port | bc: pressure|flow, p_kPa bzw. q_m3h, t_supply_C |
cap |
port | dichtes Endstück (Blindstopfen): V̇ = 0 — zum Verschließen von Anschlüssen bei Teilbereichstests; keine Parameter |
Alle wärmeübertragenden Komponenten akzeptieren q_prescribed_kW
(feste Leistung statt physikalischem Modell; Default im Editor). Das
Kühlregister rechnet wahlweise trocken (ε-NTU) oder als Greybox mit
Kondensation (ua_star_wet_kg_s + Eintrittsfeuchte).
Teilstrecken-Gruppierung: Jede Komponente kann ein Label ts: <nummer>
tragen (YAML wie Python-API). Der Bericht enthält dann eine Teilstrecken-
Tabelle, die je Gruppe die Kette(n) in Strömungsrichtung auswertet: V̇, ΣΔp
sowie p und T an Anfang und Ende jedes Abschnitts (eine klassische TS mit
Vor- + Rücklauf unter einer Nummer zerfällt in zwei Abschnitte). Konsistenz
wird geprüft: uneinheitliche Volumenströme oder Verzweigungen innerhalb einer
Gruppe (= Teilstrecke falsch geschnitten) erzeugen einen Hinweis.
Modellierungsrichtlinie — Teilstrecken-Widerstände aufteilen: C-Werte aus
Handrechnungen enthalten meist Vor- UND Rücklauf. Empfohlen ist die hälftige
Aufteilung (C/2 als eigene flow_resistance je Richtung — die Leitungen sind
in der Praxis parallel und gleich lang verlegt): Für die Kreisvolumenströme
ist das äquivalent zum konzentrierten Wert, liefert aber korrekte Druckniveaus
an allen Knoten, und die Rücklaufäste sind eigene Kanten — die thermische
Mischreihenfolge an Sammlern stimmt dann von selbst. Konzentriert man dagegen
alles in den Vorlauf, verschmelzen widerstandsfreie Rücklaufanschlüsse zu
EINEM Mischknoten (Zapfstellen „sehen" stromab eingemischtes Wasser); dann
Knoten mit link trennen. Beispiel: examples/07_twe_heizkreisverteiler.py.
Ventile: opening: 0 (bzw. die Endlagen des 3-Wege-Ventils) sperrt
exakt — die Kante wird zur Randbedingung V̇ = 0, der abgesperrte
Netzteil erhält automatisch einen Referenzdruck. Im Regelbereich
(0 < opening < 1) begrenzt das Stellverhältnis (rangeability) den
kleinsten Kv auf Kvs/R.
- Pumpen: konstante Druckdifferenz (
constant_dp) oder konstanter Volumenstrom (constant_flow, Druckerhöhung ist dann Ergebnis). - Offene Rohrenden (
open_end): Druck ODER Volumenstrom vorgebbar, plus Zulauftemperatur. - Alle Drücke sind Überdrücke (gauge). Bei inkompressiblem Fluid ohne
Verdampfung/Kondensation ist nur das Druckniveau relativ zur Atmosphäre
relevant; Randbedingungen und Ergebnisse sind einheitlich als Überdruck zu
lesen (Auslauf ins Freie:
p_kPa: 0). - Geschlossene Kreise ohne Druckvorgabe erhalten automatisch einen
Referenzdruck (150 kPa(ü) ≈ typischer Anlagenfülldruck, einstellbar über
p_ref) – nur Druckdifferenzen sind dann physikalisch relevant; ein Hinweis erscheint im Bericht. Alternativ verankert eine Quelle mitp_outdas Niveau explizit (wie ein Ausdehnungsgefäß am Erzeuger). - Inflow/Outflow (je ein Anschlusspunkt): Zulauf mit Temperatur +
(V̇ ODER Überdruck); Austritt mit (Überdruck ODER Entnahme-V̇), die
Austrittstemperatur ist Ergebnis — die Randbedingungen offener Systeme.
Speicher (
ideal_storage, Zweitor für geschlossene Kreise): Vorlauftemperatur fest, Rücklauf/Leistung Ergebnis; optional eingeprägter Volumenstrom und/oder Druckankerp_out. - Rein hydraulische Rechnung:
net.solve(thermal=False)überspringt die Energiegleichung — nützlich für Kennlinienstudien und für Fälle ohne stationäre Temperaturlösung (z.B. thermisch isolierter Umlauf mit fest vorgegebener Leistung; wird sonst erkannt und verständlich gemeldet).
- Hydraulik: SIMPLE-artige Druckkorrektur auf dem Netzgraphen. Knoten tragen p und T, Komponenten sind Kanten mit Δp = a·Q + b·Q·|Q| − Δp_Quelle. Der Impulsprädiktor in Newton-Inkrementform und die Druckkorrektur K = A·diag(1/J)·Aᵀ (J = a + 2b|Q|) machen den Schritt bei α = 1 zu einem exakten Newton-Schritt (Schur-Komplement) → typisch 3–6 Iterationen. Robustheit: Churchill-Reibungskorrelation (glatt über alle Re-Bereiche), Widerstands-Floor für Q → 0, Kv-Leckage-Floor für fast geschlossene Ventile, Divergenz-Wächter mit automatischer Relaxationshalbierung, Jacobi-Skalierung. Kompilierzeit-Checks: Druckinsel-Analyse, Bilanz fester Volumenströme.
- Thermik: nach Hydraulik-Konvergenz Upwind-Advektion; Newton-Verfahren auf der Knotenbilanz F(T) = G(T) − T (dünne Jacobi-Matrix, Kantensteigung per Differenzenquotient aus dem Komponentenmodell) mit Levenberg-Marquardt- Vertrauensbereich und Armijo-Liniensuche — lineare Netze in einem Schritt, nichtlineare quadratisch, unabhängig vom Rezirkulationsverhältnis (docs/numerik.md §2). Ideale Mischung an Knoten, UA-Verluste, Heizkörper- Exponentenmodell (Brent-Verfahren), ε-NTU-Register, exponentielle Rohr-/FBH-Modelle. Globale Energiebilanz wird geprüft und im Bericht ausgewiesen. Strömungsumkehr ist zulässig (Upwind folgt dem Vorzeichen). Robustheit: Klemmen (z.B. Erzeuger an q_max) werden über den singulären Unterraum verlassen; thermisch isolierte Umläufe mit fester Leistung (keine stationäre Lösung) werden erkannt und mit Knoten und Abhilfevorschlägen gemeldet; unplausible Austrittstemperaturen (feste Leistung bei Kleinstdurchfluss) erscheinen als Hinweis im Bericht.
| Datei | Inhalt |
|---|---|
examples/01_single_loop.yaml |
WP + Pumpe + Heizkörper (Einzelkreis) |
examples/02_parallel_radiators.yaml |
3 parallele HK-Stränge mit Strangregulierventilen |
examples/03_mixed_floorheating.yaml |
Beimischschaltung (3-Wege-Ventil) für FBH |
examples/04_heatpump_separator.yaml |
WP + hydraulische Weiche + HK-Kreis + FBH-Beimischkreis |
examples/05_umlenk_einspritz.yaml |
Umlenk- + Einspritzschaltung, Teilstrecken als Kvs-Äquivalente |
examples/06_umlenk_einspritz_flow_resistance.yaml |
wie 05, Teilstrecken direkt als C-Werte (REGuA) |
examples/07_twe_heizkreisverteiler.py |
TWE (Durchlaufprinzip) + Verteiler mit Einspritz-Regelgruppen: Auslegung (RG-Ventil, SRVs, Pumpen) + Solver-Verifikation + Abschaltfall; TS-Labels, hälftige Widerstandsaufteilung |
Validierung gegen unabhängige Referenzlösungen (FH-Burgenland-Übungen):
| Datei | Inhalt |
|---|---|
examples/validation_fh_verteiler.py |
Kennlinien-Plots (Ventilhub-Sweeps) zu Bsp 05/06 mit Referenzankern aus den Lösungsplots |
examples/08_ventilautoritaet.py |
Wirkung der Ventilautorität: installierte Kennlinien (linear/gleichprozentig) für a_V = 0.1…0.9 |
examples/09_energetikum_lueftungsregister.yaml + .py |
Reale Anlage (Energetikum-Lüftung): VE/NE-Register als Einspritzschaltung mit Durchgangsventil im Rücklauf, echte Aedifion-BEMS-IDs; Analyse: Datenblatt-Reproduktion, Einregulierung (STAD-Voreinstellung), Ventilautorität |
examples/referenzwerte_fh_verteiler.txt |
alle aus dem Lösungs-PDF extrahierten Referenzwerte (exakt vs. abgelesen) |
tests/test_validation_fh_verteiler.py |
Volllast-Volumenströme < 0.1 %, Ventilautoritäten, Kennlinien-Anker |
python3 examples/run_examples.py # alle YAML-Beispiele mit Bericht
hydraulik run <datei.yaml> --json # maschinenlesbares Ergebnis| Datei | Inhalt |
|---|---|
CLAUDE.md |
Projektleitfaden: Befehle, Struktur, Konventionen |
docs/architektur.md |
Graphmodell, Solver-Verträge, Kompilierung, Parametersystem |
docs/numerik.md |
Herleitung des Solvers (SIMPLE ≡ Newton via Schur-Komplement), Robustheitsmaßnahmen, Thermik, Testabdeckung |
docs/erweitern.md |
Anleitung: neue Komponenten hinzufügen (mit Codegerüst) |
docs/roadmap.md |
Stand, bewusste v1-Grenzen, v2-Ideen, Wiedereinstieg |

