Erweiterung „solar“¶

Hier finden Sie Funktionen, die von „PlexMap Solar“ bereitgestellt werden und unter anderem zur Berechnung eines Solardachkatasters benutzt werden können.

solar.add_resolution(pointclouds, buildings, filter)¶

Auflösung hinzufügen

Die Funktion annotiert die Auflösung aus den Punktwolken an die übergebenen Gebäude.

Parameter

pointclouds – Pointcloud
buildings – type-solar-building
filter – String

Rückgabetyp

type-solar-building

solar.border.collect_zip(borders, zipareas, zipkey)¶

PLZ sammeln

Keine Beschreibung vorhanden

Parameter

borders – type-solar-border
zipareas – Feature
zipkey – String

Rückgabetyp

type-solar-border

solar.border.export(borders)¶

Solargrenzen Tabellenexport

Bereitet die Solargrenzen in einem gut lesbaren Tabellenformat auf. Das Ergebnis dieser Funktion kann dann beispielsweise als CSV exportiert werden.

Parameter: borders – type-solar-border
Rückgabetyp: PlexMap-Objekte

solar.border.hierarchy(borders, threshold)¶

Grenzhierarchie updaten

Keine Beschreibung vorhanden

Parameter

borders – type-solar-border
threshold – Float

Rückgabetyp

type-solar-border

solar.border.sum_installations(borders, installations, thermie_installations, aggregate, city_fallback)¶

Installationen je Grenze summieren

Ist der Parameter aggregate auf True gesetzt, werden bereits vorhandene Werte mit den Installationen aufsummiert. Standardmäßig werden vorhandene Werte überschrieben. Der Parameter city_fallback gibt an, ob eine Zuordnung anhand des Stadtnamens erfolgen soll, falls keine Zuordnung über den Gemeindeschlüssel oder die PLZ möglich war.

Parameter

borders – type-solar-border
installations – type-solar-installation
thermie_installations – type-solar-installation-thermie
aggregate – Bool
city_fallback – Bool

Rückgabetyp

type-solar-border

solar.border.sum_potential(borders, roofs)¶

Potential je Grenze summieren

Keine Beschreibung vorhanden

Parameter

borders – type-solar-border
roofs – type-solar-roof

Rückgabetyp

type-solar-border

solar.buildings.annotate_address(buildings, addresses)¶

Adresse hinzufügen

Schreibt die Addressen als Attribut an die dazugehörigen Gebäude.

Parameter

buildings – type-solar-building
addresses – type-address

Rückgabetyp

type-solar-building

solar.calc_info(features)¶

Berechnungsinformationen

Gibt für die angegebenen Features die für eine Solarberechnung wichtigen Informationen (Maximale Einstrahlung in kWh/a, optimaler Winkel, Eignungsschwellen) zurück.

Parameter: features – Feature
Rückgabetyp: PlexMap-Objekte

solar.filter.suitable(roofs)¶

Geeignete Dächer filtern

Keine Beschreibung vorhanden

Parameter: roofs – type-solar-roof
Rückgabetyp: type-solar-roof

solar.get_leistung(roofs)¶

Leistung ermitteln

Keine Beschreibung vorhanden

Parameter: roofs – type-solar-roof
Rückgabetyp: Float

solar.greenroof.categories3(roofs)¶

3-Klassen-Gründach

Setzt die Gründach-Eignung auf Basis folgender Klassen: gut geeignet (0 - 15 Grad), bedingt geeignet (15 - 30 Grad), ungeeignet (> 30 Grad).

Experimentell: Name und Parameter können sich ändern.

Parameter: roofs – type-solar-roof
Rückgabetyp: type-solar-roof

solar.greenroof.detect_by_infrared(features, grids, threshold, nir, red, green)¶

Gründächer anhand Infrarot erkennen

Count for each feature how many pixels from the given grids are above a certain NIR (near infrared) value. Red-Value calculation for NIR R G: NIR * threshold > R + G. Last three parameters can be used to specify the number of NIR, Red and Green band (default is 0, 1, 2).

Parameter

features – Feature
grids – Grid
threshold – Float
nir – Int
red – Int
green – Int

Rückgabetyp

Feature

solar.greenroof.detect_by_ndvi(features, grids, threshold, slopeLE10, slopeLE21, slopeLE45)¶

Gründächer anhand NDVI erkennen

Count for each feature how many pixels from the given grids are above a certain NDVI-value. First threshold parameter is the relevant NDVI-value. Last three paramters define how many pixels need to be above that threshold to select a roof as greenroof depending on the roof slope (percentagewise).

Parameter

features – type-solar-roof
grids – Grid
threshold – Float
slopeLE10 – Float
slopeLE21 – Float
slopeLE45 – Float

Rückgabetyp

Feature

solar.greenroof.stats(roofs)¶

Gründach-Statistiken

Keine Beschreibung vorhanden

Parameter: roofs – type-solar-roof
Rückgabetyp: PlexMap-Objekte

solar.installation.create(zipcode, city, power, year)¶

Solarinstallation erstellen

Keine Beschreibung vorhanden

Parameter

zipcode – String
city – String
power – Float
year – Int

Rückgabetyp

type-solar-installation

solar.installation.load(data)¶

Installationsdaten laden

Lädt Installationsdaten der Bundesnetzagentur, sowie der Netzbetreiber TenneT und Amprion.

Parameter: data – File
Rückgabetyp: type-solar-installation

solar.installation.thermie.load(data)¶

Solaratlas-CSV laden

Lädt Thermie-Installationsdaten als CSV von Solaratlas.

Parameter: data – File
Rückgabetyp: type-solar-installation-thermie

solar.intensity(shadow, roofs)¶

Einstrahlung

Keine Beschreibung vorhanden

Parameter

shadow – Grid
roofs – type-solar-roof

Rückgabetyp

Grid

solar.mastr.import(landkreis, min_year, max_year)¶

Marktstammdatenregister

Lädt PV-Installationsdaten vom Marktstammdatenregister.

Parameter

landkreis – String
min_year – Int
max_year – Int

Rückgabetyp

type-solar-installation

solar.merge_roofs_buildings(buildings, roofs)¶

Dachinformationen auf Gebäude

Aggregiert die installierbare Leistung und die Eignungsklassen für jedes Dach eines Gebäudes.

Parameter

buildings – type-solar-building
roofs – type-solar-roof

Rückgabetyp

type-solar-building

solar.oid(height, buildings)¶

OID-Layer

Interne Verwendung in der Solarberechnung.

Parameter

height – Grid
buildings – Feature

Rückgabetyp

Grid

solar.pid(height, buildings, oid, resolution_threshold)¶

PID-Layer

Interne Verwendung in der Solarberechnung.

Parameter

height – Grid
buildings – Feature
oid – Grid
resolution_threshold – Float

Rückgabetyp

Grid

solar.pid.polygonize(pid, oid, buildings)¶

Erzeuge Dächer aus PID

Interne Verwendung in der Solarberechnung.

Parameter

pid – Grid
oid – Grid
buildings – type-solar-building

Rückgabetyp

Feature

solar.roofs(height, shadow, buildings, oid, pid, resolution_threshold)¶

Solardächer berechnen

Findet Dachseiten in den angegebenen Gebäuden und berechnet verschiedene Solarinformationen wie Einstrahlung, Ausrichtung und Neigung. Hierfür ist das Oberflächenmodell und die Verschattung notwendig. oid und pid sind optional und müssen nicht übergeben werden. Diese sind intern verwendete Layer, die durch andere Funktionen vorher berechnet werden können.

Parameter

height – Grid
shadow – Grid
buildings – type-solar-building
oid – Grid
pid – Grid
resolution_threshold – Float

Rückgabetyp

type-solar-roof

solar.roofs.enrich(roofs, max_kwha)¶

Dächer anreichern

Bringt die übergebenen Dächer auf die aktuelle Schema-Version. Dies geschieht indem alle Felder mit Daten gefüllt werden, sofern diese aus den vorhanden Daten ableitbar sind.

Parameter

roofs – type-solar-roof
max_kwha – Float

Rückgabetyp

type-solar-roof

solar.roofs.stats(roofs, by)¶

Solar-Statistiken

Gibt Statistiken über die berechneten Solardächer aus. Ist der Parameter by angegeben, wird nach diesem gruppiert. Die Anzahl der Objekte in by muss in diesem Fall mit der von roofs übereinstimmen.

Parameter

roofs – type-solar-roof
by – Anything

Rückgabetyp

PlexMap-Objekte

solar.roofs.stats_pdf(roofs, by)¶

Solar-Statistiken als PDF

Ruft die Funktion solar.roofs.stats auf und erzeugt Statistiken über die berechneten Solardächer als PDF. Ist der Parameter by angegeben, wird nach diesem gruppiert. Die Anzahl der Objekte in by muss in diesem Fall mit der von roofs übereinstimmen.

Parameter

roofs – type-solar-roof
by – Anything

Rückgabetyp

File

solar.shadow(grids)¶

Verschattung ganzjährig

Berechnet für das übergebene Oberflächenmodell (DOM) die Verschattung für jeden Pixel. Ein Pixel im Ergebnisraster hat den Wert 0, wenn dieser ganzjährig im Schatten liegt. Ein Pixel hat den Wert 100, wenn dieser nie verschattet wird.

Parameter: grids – Grid
Rückgabetyp: Grid

solar.shadow.time(grids, time, shadow_length)¶

Verschattung für Zeitpunkt

Berechnet für das übergebene Oberflächenmodell (DOM) die Verschattung für jeden übergebenen Zeitpunkt. Die Berechnung geschieht pixelweise. Ein Pixel im Ergebnisraster hat den Wert 0, wenn dieser im Schatten liegt. Ein Pixel hat den Wert 100, wenn dieser nicht verschattet wird.

Der Parameter shadow_length gibt an, für wieviele Pixel der Schatten in eine Richtung berechnet wird. Höhere Werte haben großen Einfluß auf die Laufzeit.

Parameter

grids – Grid
time – DateTime
shadow_length – Int

Rückgabetyp

Grid

solar.solarbundesliga.load(borders)¶

Solarbundesliga laden

Keine Beschreibung vorhanden

Parameter: borders – type-solar-border
Rückgabetyp: type-solar-border

solar.store_historic(borders, installations, thermie_installations)¶

Historische Daten speichern

Die Funktion analysiert und speichert die historischen Installationsdaten. Achtung: Sie operiert global und hat sofortige Auswirkungen auf die angezeigten Datensätze.

Parameter

borders – type-solar-border
installations – type-solar-installation
thermie_installations – type-solar-installation-thermie

solar.update_potential(height, shadow, roofs)¶

Solardächer aktualisieren

Keine Beschreibung vorhanden

Parameter

height – Grid
shadow – Grid
roofs – type-solar-roof

Rückgabetyp

type-solar-roof