# Lizenz # 
Der Code wird hiermit unter der MIT Linzenz veröffentlicht:
Copyright (c) 	2024 	Justus Degenhardt
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
The Software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.


# Auswahl der Input-Daten und Input-Parameter#
    • => AOI Layer: 
        ◦ AOI Layer sollte folgende Eigenschaften haben: CRS ist EPSG 32632; Geometrietyp ist MultiPolygon; Dateiformat ist .gpkg-Dateiformat (mit anderen Eigenschaften geht es vielleicht auch, aber wurde nicht ausführlich getestet)
        ◦ AOI-Grenze sollte keine Gebäude schneiden, ansonsten wird nur der Teil des Gebäudes berücksichtigt, der innerhalb des Polygons liegt

    • => Flurstück-Layer : der Flurstück Layer braucht eine Spalte „flurstueck_label“ wo für jedes Flurstück ein eigener Wert gespeichert ist (ansonsten werden Gebiete mit keinem/gleichem Wert wie ein Flurstück betrachtet)

    • => Straßen-Layer: die Auswahl der Strassen ist nicht mit ins Modell eingebaut! D.h. user ist dafür verantwortlich, das im Strassen layer nur solche Straßen sind, wo prinzipiell Leitungen gelegt werden können

    • => Es ist vorteilhaft, wenn die Inputdaten in einem projezierten Koordinatensystem sind (bei geografischen Koordinatensystemen wie EPSG 4326 kann es zu Fehler kommen)

    • => Input-Parameter „Spaltename, wo Werte fuer Gebauede-Filter enthalten sind“: dort muss der Spaltenname ohne Anführungszeichen eingegeben werden

    • => Input-Parameter „CRS“: es sollte ein projeziertes Koordinatensystem eingegeben werden (mit geografischen Koordinatensystemen wurde das Modell nicht getestet)

# trouble shouting #
    • => Fehler: v.net.steiner-Tool kann zwei Punkte nicht verbinden 
        ◦ Fehlermeldung im log-panel „Fehler: Station am Knoten [xx] kann nicht mit der Station am Knoten [xx] verbunden werden“)
        ◦ Schritte zur Fehlerumgehung: 
            ▪ (1) klick im Modell bei v.net.steiner auf „deactivate“
            ▪ (2) Modell ausführen 
            ▪ (3) im QGIS Hauptfenster „v.net.steiner“ ausführen mit den Zwischenergebnis-Layern „Alle-Netz-Punkte“ und „Grundnetzwerk“ 
        ----> Hier ist ein Issue dazu auf Github: https://github.com/OSGeo/grass/issues/1572
        ----> Dieser Fehler tritt relativ häufig auf. Für die Verbesserung des Modells wäre es daher wichtig, das Tool v.net.steiner mit einem zuverlässigeren Steinerbaum-Algorithmus zu ersetzen (oder selber einen Steinerbaum-Algorithmus zu programmieren, bspw angelehnt an: https://github.com/ivandochev/hypothetical-heating-grids/blob/master/Hypothetical%20Heating%20Grids_District_Heating_Conference_FIN.py)


    • => Fehler: Modell hängt sich auf, bei Erstellung des Netzwerkes 
        ◦ ggf. erscheint im log-panel in der untersten Zeile eine Meldung, dass v.net.steiner nicht in background thread ausgeführt werden kann und daher zum main thread gewechselt wird
        ◦ Lösung: Versuchen, das AOI zu verkleinern. Es kann sein, dass es bei mehr als 300 anzuschließenden Gebäude zu Problemen führt.

    • => Fehler: Algorithmus-Schritte nach v.net.steiner funktionieren nicht 
        ◦ im log-panel kommt u.U. die Fehlermeldung, dass Schritte „teillaengen“ und „Netzgesamtlaenge“ nicht ausgeführt werden können)
        ◦ Lösung: im graphical modeller in „v.net.steiner“ ändern wo der Output gespeichert werden soll. Dafür unten in den Einstellungen von v.net.steirn „Network Steiner“ auf „value“ setzen und dann den Speicherpfad mit Dateinamen und Dateiendung eintragen. (bspw. /home/justus/Programme/QGIS/BA/Ergebnisse/output/Steinernetz_2024-06-19_12_06.gpkg)

# Sonstige Hinweise #
    • => Wenn mind. eine Hausanschlussleitung zu einer Straße führt, die isoliert vom restlichen Netzwerk ist, kann das gesamte Netz nicht erstellt werden

    • => Das Modell wurde für QGIS Projekt entwickelt, mit „Meter“ als Längeneinheit.

# Ergebnisse # 
    • => Wenn für das Projekt ein Ellipsoid festgelegt wurde, wird die berechnete Länge ellipsoidisch sein, und wenn kein Ellipsoid festgelegt wurde, wird die berechnete Länge planimetrisch sein.

    • => Der Layer „Gesamtwaermebedarf“ enthält den aggregierten Wärmebedarf des Untersuchungsgebietes.