Bauphysik · menschliche Dokumentation

Den Rechenkern wirklich verstehen

Ein geführter Einstieg in Finite Elemente und die aktuell implementierten Bauphysik-Berechnungen. Zuerst anschaulich, danach bei Bedarf mathematisch und bis zur konkreten Stelle im Python-Core.

1 · Wozu Finite Elemente?

Viele bauphysikalische Aufgaben kennen wir als Differentialgleichung: Wärme, Feuchte oder Strömung ändern sich räumlich. Für einfache Geometrien gibt es Handformeln. Für eine Wärmebrücke, ein kompliziertes Bauteil oder gekoppelte Strömung gibt es meist keine geschlossene Formel mehr.

Die Finite-Elemente-Methode, kurz FEM, ersetzt das kontinuierliche Problem nicht durch eine andere Physik. Sie zerlegt lediglich den Raum in viele kleine Elemente und beschreibt das gesuchte Feld dort mit einfachen Funktionen. Aus einer Differentialgleichung wird so ein großes algebraisches Gleichungssystem.

1 · PHYSIKWelche Erhaltungsgleichung gilt?
2 · GEOMETRIEWelche Bereiche und Materialien gibt es?
3 · NETZRaum in Dreiecke oder Tetraeder zerlegen.
4 · ANSATZFeld innerhalb jedes Elements annähern.
5 · ASSEMBLYLokale Gleichungen zur globalen Matrix zusammensetzen.
6 · LÖSENKnotenwerte, z. B. Temperaturen, berechnen.
7 · PRÜFENBilanz, Residuum und Netzkonvergenz kontrollieren.
Wichtig: Ein Solver kann numerisch konvergieren und trotzdem ein ungeeignetes physikalisches Modell oder ein zu grobes Netz verwenden. Im Core werden deshalb Solver-Konvergenz, physikalische Bilanz und Mesh-Konvergenz getrennt behandelt.
So ist es umgesetzt
Technische Doku: FEM-Core · technische Doku
Implementierung: PHYSICS_CORE.md · Model · Analysis

2 · Der komplette FEM-Ablauf im Bauphysik-Core

  1. Problem festlegen: Welche Größe suchen wir? Temperatur, Geschwindigkeit, Druck, Feuchte?
  2. Gleichung wählen: Zum Beispiel stationäre Wärmeleitung -∇·(λ∇T)=Q.
  3. Geometrie und Materialien: Bauteilbereiche werden Domains zugeordnet; jede Domain verweist auf Materialeigenschaften.
  4. Mesh erzeugen: 2D derzeit mit TRI3-Dreiecken, 3D mit TET4-Tetraedern.
  5. Felder und Freiheitsgrade: Temperatur ist z. B. ein skalares P1-Feld; Geschwindigkeit bei Taylor-Hood ein vektorielles P2-Feld.
  6. Elementgleichungen: Jedes Element liefert eine kleine Matrix und einen kleinen Lastvektor.
  7. Assembly: Gemeinsame Knoten/Freiheitsgrade sorgen dafür, dass alle Elementbeiträge in dieselbe globale Matrix geschrieben werden.
  8. Randbedingungen: Vorgegebene Werte oder Flüsse werden ergänzt.
  9. Solver: Das globale System wird direkt oder iterativ gelöst; nichtlineare Probleme werden zusätzlich iteriert.
  10. Postprocessing: Wärmeströme, Oberflächentemperaturen, Massenströme und andere Zielgrößen werden abgeleitet.
  11. Qualitätssicherung: Bilanz und Netzverfeinerung entscheiden, ob das Ergebnis technisch belastbar ist.
Wo liegt dieser Ablauf im Code?
SchrittCore-DateiAufgabe
Ansatzfunktionen & Quadratursrc/femcore/basis.pyP1/P2-Lagrange-Funktionen und Integrationspunkte.
Elementgeometriesrc/femcore/elements.pyJacobi-Matrix, Fläche/Volumen, Gradientenabbildung.
Freiheitsgradesrc/femcore/function_space.pyP1-/P2-DOFs, Kanten-DOFs, globale Offsets.
Physiksrc/femcore/physics.pyElementbeiträge für Wärme, Stokes, Navier-Stokes usw.
Zusammensetzensrc/femcore/assembly.pyLokale Matrizen in globale Sparse-Matrix streuen.
Analysesrc/femcore/analysis.pyValidieren, assemblieren, Randbedingungen anwenden, lösen.
Netzkonvergenzsrc/femcore/convergence.pyZielgröße über feinere Netze vergleichen.
So ist es umgesetzt
Technische Doku: Model, Mesh & Felder
Implementierung: FunctionSpace · ElementContext · Assembler

3 · Netz, Knoten, Elemente und Freiheitsgrade

Ein Knoten ist ein geometrischer Punkt. Ein Element verbindet mehrere Knoten zu einem kleinen Teilgebiet. Das aktuelle Grundnetz verwendet TRI3 in 2D und TET4 in 3D.

TRI3Dreieck mit 3 Eckknoten. Grundlage der 2D-Berechnung.
TET4Tetraeder mit 4 Eckknoten. Grundlage der 3D-Berechnung.
P1-FeldLinearer Verlauf im Element. Ein skalarer Freiheitsgrad je Knoten.
P2-FeldQuadratischer Verlauf. Zusätzliche Freiheitsgrade auf den Kanten.

DOF bedeutet Degree of Freedom, also Freiheitsgrad. Bei einem P1-Temperaturfeld ist jeder Temperaturwert an einem Netzknoten ein DOF. Bei einer 2D-P2-Geschwindigkeit besitzt jeder geometrische P2-Punkt zwei Komponenten, also zwei DOFs.

Warum benutzt die Strömung P2 für Geschwindigkeit und P1 für Druck?

Der Core verwendet für Stokes und Navier-Stokes die klassische Taylor-Hood-Kombination P2/P1. Der Geschwindigkeitsraum ist damit reicher als der Druckraum. Das ist eine etablierte Möglichkeit, das gekoppelte Geschwindigkeits-Druck-Problem stabil zu diskretisieren. Im Code prüft StokesFlow.validate_spaces() genau diese Kombination.

Was macht die Jacobi-Matrix?

Die Ansatzfunktionen werden auf einem einfachen Referenzdreieck oder Referenztetraeder definiert. Die reale Elementgeometrie kann aber gedreht, gestreckt oder verzerrt sein. Die Jacobi-Matrix J beschreibt diese Abbildung. Mit J⁻¹ werden die Gradienten aus dem Referenzelement in reale Koordinaten übertragen. Genau das geschieht in elements.py.

So ist es umgesetzt
Technische Doku: Model, Mesh & Felder
Implementierung: elements.py · function_space.py · mesh.py

4 · Lagrange-Ansatzfunktionen, λ und das Kronecker-Delta

Das ist der Punkt, an dem FEM oft unnötig abstrakt wirkt. Die Grundidee ist sehr einfach: Innerhalb eines Elements wird die unbekannte Größe aus wenigen einfachen Gewichtsfunktionen zusammengesetzt.

P1 im Dreieck

T(r,s) ≈ N₁(r,s)·T₁ + N₂(r,s)·T₂ + N₃(r,s)·T₃ N₁ = 1-r-s N₂ = r N₃ = s

T₁, T₂, T₃ sind die unbekannten Temperaturen an den drei Eckknoten. Die Funktionen Nᵢ heißen Lagrange-Ansatzfunktionen oder Formfunktionen.

Was bedeutet λ?

In Lehrbüchern werden die drei baryzentrischen Koordinaten eines Dreiecks häufig λ₁, λ₂, λ₃ genannt. Im Core heißen sie in basis.py schlicht L. Für das Referenzdreieck gilt:

λ₁ = 1-r-s λ₂ = r λ₃ = s λ₁ + λ₂ + λ₃ = 1

Jedes λᵢ sagt anschaulich, wie stark ein Eckpunkt an der aktuellen Position beteiligt ist.

Notationsfalle: λᵢ mit Index bezeichnet hier eine baryzentrische Koordinate. In der Bauphysik steht λ ohne diesen Index häufig für die Wärmeleitfähigkeit in W/(mK). Es ist derselbe griechische Buchstabe, aber eine andere Größe; im Python-Core heißt die Wärmeleitfähigkeit deshalb meist k bzw. thermal_conductivity.

Kronecker-Delta δᵢⱼ

δᵢⱼ = 1, wenn i = j δᵢⱼ = 0, wenn i ≠ j Lagrange-Eigenschaft: Nᵢ(xⱼ) = δᵢⱼ

Das bedeutet: Die Ansatzfunktion eines Knotens ist an „ihrem“ Knoten genau 1 und an den anderen Knoten 0. Deshalb ist der Koeffizient Tᵢ tatsächlich der Feldwert am Knoten und nicht irgendein abstrakter Parameter.

Wie sehen die P2-Funktionen aus?

Bei P2 kommen zu den Eckknoten die Kantenmitten hinzu. Mit baryzentrischen Koordinaten schreibt man für Eck- und Kantenfunktionen:

Eckknoten: Nᵢ = λᵢ(2λᵢ-1) Kante i-j: Nᵢⱼ = 4 λᵢ λⱼ

Genau diese Formeln stehen in tri_p2_shape() und tet_p2_shape(). Das ist keine ähnliche Näherung, sondern direkt die im Core implementierte Lagrange-Basis.

Warum müssen sich alle Ansatzfunktionen zu 1 summieren?

Diese Eigenschaft heißt Partition of Unity. Sie garantiert unter anderem, dass ein konstantes Feld exakt dargestellt werden kann. Wenn überall 20 °C vorgegeben sind, soll die Interpolation nicht plötzlich innerhalb eines Elements 19,8 °C erzeugen. Die P1- und P2-Tests des Cores prüfen diese grundlegenden Eigenschaften.

So ist es umgesetzt
Technische Doku: Model, Mesh & Felder
Implementierung: tri_p1_shape / tri_p2_shape · TET4/P2-Basis · Basis-Tests

5 · Wie aus der Wärmegleichung eine Matrix wird

Als Beispiel dient die im Core implementierte stationäre Wärmeleitung:

starke Form: -∇ · (λ ∇T) = Q

T ist die Temperatur, λ die Wärmeleitfähigkeit und Q eine volumetrische Wärmequelle. ∇T ist der Temperaturgradient.

FEM arbeitet üblicherweise nicht direkt mit dieser „starken“ Form. Man multipliziert sie mit einer Testfunktion v, integriert über das Gebiet und integriert den Ableitungsterm partiell. Dadurch entsteht die schwache Form:

∫Ω λ ∇v · ∇T dΩ = ∫Ω v Q dΩ + Beiträge aus natürlichen Randbedingungen

Jetzt setzt man für Temperatur und Testfunktion dieselben Ansatzfunktionen ein. Für ein einzelnes Element folgt:

Kᵉᵢⱼ = ∫Ωᵉ λ ∇Nᵢ · ∇Nⱼ dΩ fᵉᵢ = ∫Ωᵉ Nᵢ Q dΩ

Das ist die Elementmatrix Kᵉ und der Elementvektor fᵉ. In HeatConduction.element_contribution() steht genau diese Mathematik:

K += k * (grad @ grad.T) * w f += volumetric_source * N * w

w enthält dabei Quadraturgewicht und geometrische Abbildung. Die globale Gleichung lautet anschließend:

K · u = f

Für reine Wärmeleitung ist u der Vektor aller unbekannten Knotentemperaturen.

Warum numerische Quadratur?

Integrale werden im Computer als gewichtete Summe an ausgewählten Integrationspunkten ausgewertet. Das nennt man Gauß-Quadratur. basis.py enthält Quadraturregeln bis zum benötigten Polynomgrad für TRI3 und TET4. Für einfache lineare Wärmeleitung genügt eine niedrigere Ordnung; für P2-/Konvektionsterme werden höhergradige Regeln verwendet.

Was bedeutet „Assembly“?

Jedes Element kennt nur seine lokalen DOFs. Ein Knoten gehört aber meist zu mehreren Elementen. Der Assembler übersetzt lokale DOF-Nummern in globale DOF-Nummern und addiert alle Beiträge in eine Sparse-Matrix. „Sparse“ bedeutet: Es werden nur die tatsächlich von Null verschiedenen Matrixeinträge gespeichert.

So ist es umgesetzt
Technische Doku: Wärmeleitung & Wärmebrücken
Implementierung: HeatConduction.element_contribution · ElementContext · Assembler.assemble

6 · Randbedingungen: Was kommt von außen?

TypAnschaulichBauphysik-Beispiel
DirichletFeldwert ist vorgegeben.Oberfläche exakt auf 20 °C.
NeumannFluss ist vorgegeben.Definierte Wärmestromdichte.
RobinFluss hängt vom Feldwert ab.Wärmeübergang q = h(T∞-Tₛ).

Für Wärmebrücken ist Robin oft realistischer als eine fest vorgegebene Oberflächentemperatur, weil Innen- und Außen-Wärmeübergangswiderstände abgebildet werden können.

Warum heißt Neumann/Robin „natürliche“ Randbedingung?

Bei der partiellen Integration der schwachen Form entstehen Randintegrale automatisch. Flüsse passen deshalb direkt in die Variationsformulierung. Dirichlet-Werte werden dagegen als Zwangsbedingung auf Freiheitsgrade gesetzt; der Core verändert dafür Matrix und rechte Seite.

Wie funktionieren offene Strömungsgrenzen?

Der Core besitzt unter anderem PressureTractionBC und PorousOpeningBC. Bei feuchter Luft setzen ThermalReservoirBC und AdvectiveReservoirBC Außenwerte nur dort, wo tatsächlich Luft einströmt. Bei Ausströmung bleibt der innere Zustand maßgebend. Dadurch kann eine einzige Öffnung lokal gleichzeitig Ein- und Ausströmung enthalten.

So ist es umgesetzt
Technische Doku: Randbedingungen
Implementierung: boundary.py · Assembler natural BCs · Dirichlet constraints

7 · Solver und nichtlineare Iteration

Nach Assembly und Randbedingungen liegt ein lineares Gleichungssystem vor. Kleine und mittlere Systeme können direkt gelöst werden; für größere Systeme gibt es einen GMRES-Pfad. Bei Navier-Stokes, variabler Dichte oder feuchteabhängigen Materialwerten reicht ein einzelner linearer Solve nicht.

Picard-Idee

AMit einem vorhandenen Zustand starten.
BNichtlineare Koeffizienten aus diesem Zustand bestimmen.
CDas dadurch linearisierte System lösen.
DNeuen und alten Zustand vergleichen.
EBis zur Toleranz wiederholen.

PicardNavierStokesAnalysis macht dies für die stationäre Navier-Stokes-Strömung. Der gekoppelte Low-Mach-Pfad iteriert Strömung, Temperatur und optional Feuchte. Die instationäre poröse Hygrothermik aktualisiert ihre nichtlinearen Materialkennwerte ebenfalls per Picard-Iteration.

Grenze des aktuellen 3D-Solverpfads: Für sehr große Sattelpunktprobleme ist der vorhandene GMRES/Jacobi-Pfad eine Grundlage, aber noch kein produktionsreifer Ersatz für Block-/Schur-/PETSc-artige Preconditioner.
So ist es umgesetzt
Technische Doku: Solver & Konvergenz
Implementierung: analysis.py · solver.py · low_mach_analysis.py · hygrothermal.py

8 · Verfeinerung, Konvergenz und Validierung

„Die Rechnung ist durchgelaufen“ ist kein Qualitätskriterium. Der Core trennt mindestens drei Fragen.

Solver-KonvergenzWurde das algebraische bzw. nichtlineare Gleichungssystem hinreichend gelöst?
BilanzSchließen Energie, Masse oder Stofftransport physikalisch?
Mesh-KonvergenzBleibt die relevante technische Zielgröße bei feinerem Netz stabil?

Aktueller Mesh-Konvergenztest

relative Änderung = |q_neu - q_alt| / max(|q_neu|, ε)

MeshConvergenceStudy berechnet eine frei definierbare Zielgröße q auf zunehmend feinen Auflösungen und akzeptiert sie, wenn die relative Änderung unter der Toleranz liegt und die Mindestzahl an Stufen erreicht ist.

Für eine Wärmebrücke sollte man nicht nur irgendeine Knotentemperatur beobachten, sondern mindestens technisch relevante QoIs wie Gesamtwärmestrom und minimale innere Oberflächentemperatur.

Merksatz: Solver-Konvergenz sagt, ob wir die diskretisierte Aufgabe gelöst haben. Mesh-Konvergenz sagt, ob diese Diskretisierung fein genug ist. Validierung sagt, ob die zugrunde liegende Modellierung die reale Physik hinreichend trifft.
So ist es umgesetzt
Technische Doku: Solver & Konvergenz
Implementierung: MeshConvergenceStudy · postprocessing.py · VALIDATION_STATUS.md

9 · Welche Berechnungen gibt es aktuell?

Nicht jede Berechnung im Bauphysik-Repo benutzt denselben Rechenweg. Das ist bewusst so.

BerechnungRechenwegKernidee / aktueller StandImplementierung / technische Doku
Stationäre WärmeleitungFEM, P1, TRI3/TET4HeatConduction; Grundlage für Temperaturfelder und Wärmebrücken.Wärme-Doku · physics.py
2D/3D WärmebrückenFEM + PostprocessingWärmestrom, Oberflächentemperaturen und Netzkonvergenz aus demselben Wärmeleitungs-Core.Wärmebrücken-Doku · postprocessing.py
Stokes / Navier-StokesFEM Taylor-Hood P2/P1Inkompressible laminare Strömung; Navier-Stokes per Picard/Oseen.Strömungs-Doku · physics.py
Naturkonvektiongekoppelte FEMBoussinesq-Vergleichspfad oder variable-Dichte-Low-Mach für feuchte Luft.Strömungs-Doku · low_mach.py
Feuchte in strömender Luftkonservativer FEM-SkalartransportHumidityRatioTransport mit Rückkopplung auf die Dichte.Feuchtluft-Doku · moisture.py
Kondensation / Frost an Oberflächengekoppelte RandphysikMassentransport und Latentwärme werden aus derselben Phasenwechselrate gespeist.Phasenwechsel-Doku · phase_change.py
Deposit / Vereisung von Öffnungenquasi-stationäre ZustandsfortschreibungLösen → Deposit fortschreiben → Öffnungsgeometrie aktualisieren → neu lösen.Deposit-Doku · openings.py
Poröse Bauteilfeuchteinstationäre T–φ-FEMHygrothermalTransientAnalysis: Wärme + Feuchtespeicherung + Dampf-/Flüssigtransport, Backward Euler, Picard.technischer Guide · hygrothermal.py
Glaservereinfachtes VergleichsverfahrenOptionaler Vergleich in der UI; nicht der eigentliche hygrothermische Feldsolver.hygrothermal_mvp.py
Raumakustik Schule/Kitakein FEMEyring-Nachhall, Reflexionen 1. Ordnung per Image-Source und räumlicher nicht-normativer STI-Proxy.room_acoustics.py · Tests
Vertiefung: variable-Dichte-Feuchtluft

Der bevorzugte Feuchtluftpfad verwendet lokal berechnete Dichte. Die Kontinuitätsgleichung lautet:

∇ · (ρ u) = 0

Die Dichte folgt aus Temperatur, Feuchteverhältnis und thermodynamischem Druck. Dadurch koppeln sich Temperatur und Feuchte an die Strömung zurück. Das ist für größere Temperaturunterschiede physikalisch vollständiger als eine reine Boussinesq-Näherung.

Vertiefung: poröse Hygrothermik T–φ

Primäre Unbekannte sind Temperatur T und relative Feuchte φ. Die Feuchtegleichung enthält Sorptionsspeicherung, kapillaren Transport und Dampfdiffusion:

dw/dφ · ∂φ/∂t = div( Dφ ∇φ + δp ∇(φ · psat(T)) )

Die Wärmegleichung enthält Wärmeleitung und optional den latenten Enthalpietransport des diffundierenden Dampfes. Zeitlich wird vollständig implizit mit Backward Euler integriert. Der aktuelle Core-MVP ist noch kein normativ validiertes Nachweisverfahren; Vergleichs- und Benchmarkvalidierungen stehen ausdrücklich noch an.

Vertiefung: Raumakustik

Das Klassenzimmer-Modul trennt drei Ebenen: diffuse Nachhallzeit nach Eyring, geometrische Reflexionen erster Ordnung über Spiegelquellen und einen schnellen STI-ähnlichen Vergleichswert aus Modulationsübertragung und SNR. Der STI-Proxy beansprucht ausdrücklich keine Konformität mit IEC 60268-16.

10 · Mini-Handrechnung: Wärmeleitung mit einem Element

Für das Verständnis nehmen wir absichtlich ein 1D-Stabelement. Der produktive Core arbeitet bei Wärme mit 2D-Dreiecken bzw. 3D-Tetraedern, aber die Logik ist dieselbe.

Gegeben: Wandstreifen der Dicke L = 0,20 m, Wärmeleitfähigkeit λ = 0,040 W/(mK), Fläche A = 1 m². Links 20 °C, rechts 0 °C.

1. Ansatzfunktionen

N₁(x) = 1 - x/L N₂(x) = x/L

2. Elementmatrix

Kᵉ = λA/L · [ 1 -1 -1 1 ] λA/L = 0,040 / 0,20 = 0,20 W/K Kᵉ = [ 0,20 -0,20 -0,20 0,20 ] W/K

3. Temperaturen einsetzen

Da beide Randtemperaturen vorgegeben sind, muss hier kein innerer Freiheitsgrad gelöst werden. Der Wärmestrom ergibt sich direkt aus der Differenz:

Q̇ = λA/L · (20 - 0) = 0,20 · 20 = 4 W q = 4 W/m²

Bei einem realen 2D-Wärmebrückennetz macht der Core dasselbe Prinzip für jedes Dreieck: Gradienten der Ansatzfunktionen bestimmen, lokale Leitfähigkeitsmatrix integrieren, alle Elementmatrizen zusammensetzen und anschließend die unbekannten Knotenwerte lösen.

Was wird in 2D anders?

Statt der Ableitungen dN/dx entstehen Gradienten ∇N = [∂N/∂x, ∂N/∂y]. Aus dem Produkt ∇Nᵢ·∇Nⱼ entsteht der jeweilige Matrixeintrag. Die Geometrie des Dreiecks steckt über die Jacobi-Abbildung und die Elementfläche im Integral.

So ist es umgesetzt
Technische Doku: Wärmeleitung & Wärmebrücken
Implementierung: HeatConduction · TRI3/TET4-Geometrie · Wärme-Postprocessing

11 · Kleines FEM-Glossar

BegriffBedeutung
FeldEine räumlich verteilte Größe, z. B. Temperatur T(x,y).
ElementKleines Teilgebiet des Netzes, aktuell TRI3 oder TET4.
KnotenGeometrischer Punkt des Netzes.
DOFFreiheitsgrad; eine unbekannte algebraische Größe.
P1 / P2Polynomordnung der Lagrange-Basis: linear / quadratisch.
NᵢAnsatz- bzw. Formfunktion.
λᵢBaryzentrische Koordinate; im Code der P2-Basis als L bezeichnet.
δᵢⱼKronecker-Delta; 1 bei i=j, sonst 0.
∇Nabla-Operator; erzeugt z. B. den Gradienten einer Temperatur.
starke FormDie ursprüngliche Differentialgleichung mit entsprechend hohen Ableitungen.
schwache FormIntegralform nach Multiplikation mit Testfunktion und partieller Integration.
Jacobi-Matrix JAbbildung vom Referenzelement in die reale Elementgeometrie.
QuadraturNumerische Integration über ausgewählte Punkte und Gewichte.
AssemblyAddieren lokaler Elementbeiträge in das globale Gleichungssystem.
ResidualMaß dafür, wie genau die berechnete Lösung das algebraische System erfüllt.
QoIQuantity of Interest: technische Zielgröße, z. B. Gesamtwärmestrom oder Tmin.
Picard-IterationWiederholte Linearisierung eines nichtlinearen Problems mit dem jeweils letzten Zustand.
SUPGStabilisierung für advektionsdominierte Transportprobleme.
Taylor-HoodStabile P2-Geschwindigkeit/P1-Druck-Kombination für inkompressible Strömung.

Für API-Signaturen, Entwicklerregeln, aktuelle Validierungs-Gates und Session-Handover bleibt die technische FEM-Core-Dokumentation die maßgebliche Referenz.