ScenarioModel - Szenarien (JSON)

Diese Struktur definiert Lastszenarien im JSON-Format.

Grundstruktur

{
  "scenarios": [
    {
      "ID": "Starklast",
      "nm1": true,
      "voltageMode": "nennspannung",
      "scaleTags": [
        {"scaleTag": "Haushaltslast", "value": 1.0},
        {"scaleTag": "Photovoltaik", "value": 0.0}
      ]
    }
  ]
}

Hauptparameter

Schlüssel	Beschreibung	Typ	Optional	Default
ID	Eindeutige ID des Szenarios	String	Nein	-
nm1	(n-1)-Sicherheit erforderlich?	Boolean	Ja	true
scaleTags	Skalierungsfaktoren für Lastarten	ScaleTagModel[]	Ja	[]

Spannungslevel

Schlüssel	Beschreibung	Werte	Optional	Default
voltageMode	Spannungslevel an den Umspannwerken	nennspannung, nennspannung_min, nennspannung_max	Ja	nennspannung

Spannungslevel-Modi

• nennspannung: Standard-Nennspannung (100%)
• nennspannung_min: Unteres Spannungsband (aus NENNSPANNUNG_MIN in PointProperties)
• nennspannung_max: Oberes Spannungsband (aus NENNSPANNUNG_MAX in PointProperties)

Erweiterte Optionen

Schlüssel	Beschreibung	Typ	Optional
supportYear	Stützjahr für das Szenario	Integer+	Ja
operatingTime_h	Betriebsstunden für Netzverlustberechnung	Double+	Ja
relevantAssets	Geltungsbereich	String	Ja
scenarioType	Art der Lastflussprüfung	String	Ja

relevantAssets

Definiert, für welche Betriebsmittel das Szenario gelten soll:

• Alle - Alle Betriebsmittel (Default)
• Leitungen und Knoten - Nur Leitungen und Knoten
• Transformator - Nur Transformatoren

scenarioType

Definiert die Art der Lastflussprüfung:

• Standard - Prüft Spannungen gegen den Nennwert (Default)
• zulässige_spannungsänderung - Prüft gegen die Leerlaufspannung

ScaleTagModel

Definiert den Skalierungsfaktor für einen scale Tag:

Schlüssel	Beschreibung	Typ	Optional
scaleTag	Name der Skalierungszone	String	Nein
value	Skalierungsfaktor	Double+	Nein

Beispiel ScaleTags

"scaleTags": [
  {"scaleTag": "Haushaltslast", "value": 1.0},
  {"scaleTag": "Wärmepumpe", "value": 0.8},
  {"scaleTag": "Photovoltaik", "value": 0.0},
  {"scaleTag": "E-Fahrzeug", "value": 0.6}
]

Vollständige Beispiele

Starklast-Szenario

{
  "ID": "Starklast_2025",
  "nm1": true,
  "voltageMode": "nennspannung",
  "operatingTime_h": 2000,
  "supportYear": 2025,
  "relevantAssets": "Alle",
  "scenarioType": "Standard",
  "scaleTags": [
    {"scaleTag": "Haushaltslast", "value": 1.0},
    {"scaleTag": "Wärmepumpe", "value": 1.0},
    {"scaleTag": "Photovoltaik", "value": 0.0},
    {"scaleTag": "Windenergie", "value": 0.0},
    {"scaleTag": "E-Fahrzeug", "value": 0.8}
  ]
}

Starkeinspeisung-Szenario

{
  "ID": "Starkeinspeisung_2025",
  "nm1": true,
  "voltageMode": "nennspannung_max",
  "operatingTime_h": 1500,
  "supportYear": 2025,
  "scaleTags": [
    {"scaleTag": "Haushaltslast", "value": 0.3},
    {"scaleTag": "Wärmepumpe", "value": 0.0},
    {"scaleTag": "Photovoltaik", "value": 1.0},
    {"scaleTag": "Windenergie", "value": 1.0},
    {"scaleTag": "E-Fahrzeug", "value": 0.2}
  ]
}

Betriebsstunden und Netzverluste

Wenn operatingTime_h angegeben ist, berechnet Optera die Netzverlustkosten:

• Basierend auf powerflow.ActivePowerLossCosts_EuroPerMWh
• Basierend auf powerflow.ReactivePowerLossCosts_EuroPerMWh
• Formel: Kosten = Verluste × Betriebsstunden × Kosten_pro_MWh

Siehe auch

• Excel-Szenarien
• PointProperties
• JSON-Übersicht