Domänen-API

Aus Wiki openKONSEQUENZ
Version vom 30. Juni 2017, 17:30 Uhr von FKorb (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „=Topologiedaten= Die Quellsystem-API (Source System API) stellt u. A. verschiedene Schnittstellen bereit, um topologische Elemente eines Netzes abfragen zu kö…“)

(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Wechseln zu: Navigation, Suche

Topologiedaten

Die Quellsystem-API (Source System API) stellt u. A. verschiedene Schnittstellen bereit, um topologische Elemente eines Netzes abfragen zu können. Die Aufgabe der Quellsystem-API ist darauf beschränkt, den Aufbau eines vollständigen Topologiemodells zu unterstützen. Umfassende Abfrage- und Selektionsmöglichkeiten werden nicht angeboten. Dies ist Aufgabe einer nachgelagerten Komponente (Topologiedatenmanagement). Diese Restriktion soll helfen, die datenliefernden Quellsysteme der Netzbetreiber zu entlasten und die Integration der Quellsystem-API zu erleichtern.

Um ein vollständiges Topologiemodell aufbauen zu können, stellt die Quellsystem-API prinzipiell drei Arten von Daten zur Verfügung:

  • topologische Basiselemente: Topologische Basiselemente stellen die elektrisch leitenden Elemente in der Topologie dar. Hierzu zählen u. A. Tranformatoren, Leistungsschalter, Sammelschienen. Die Verbindung zwischen den einzelnen Basiselementen erfolgt über spezielle Knoten (im CIM ConnectivityNode). Jedes Basiselement besitzt hierzu einen Verweis auf mindestens einen Verbindungsknoten. Über den Vergleich der Verbindungsknoten können die Zusammenhänge und Verknüpfungen der Basiselemente hergestellt werden.
  • Kategorisierung: Hinter "Kategorisierung" verbirgt sich die Einteilung in bestimmte Arten von Elementen, die modellierungstechnisch gleich sind. Netzbetreiber haben hierüber die Möglichkeit, eigene Einteilung, die unternehmensspezifisch sind, vorzunehmen. Als Beispiel können hier Leitungsarten ("Hauptleitung", "Abzweig", ...) oder Umspannwerkarten ("Umspannwerk", "Ortsnetztrafo", ...) genannt werden.
  • Gruppierung: Mit Hilfe von Gruppierungen können topologische Basiselemente zu größeren Einheiten zusammengefasst werden. Dies sind zum Beispiel Umspannwerke, Leitungen, Felder.

Im Folgenden werden die Schnittstellen vorgestellt, die zum Aufbau einer Topologie verwendet werden können.

Warning-yellow.icon.svg Bei der Betrachtung der Schnittstellendefinitionen im Swagger Editor werden u. U. Fehler angezeigt, da bestimmte Verweise gemeinsam genutzter Modellbeschreibungen nicht aufgelöst werden können.
Dies ist kein Fehler im Schnittstellendesign, sondern eine Eigenschaft des Editors.

allgemeine Topologieelemente

Bezeichnung Typ Beschreibung
Nennspannung Kategorisierung
http-Methode: GET
Bezeichnung: base-voltages
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Netzgebiet Gruppierung
http-Methode: GET
Bezeichnung: geographical-regions
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Teilnetzgebiet Gruppierung
http-Methode: GET
Bezeichnung: sub-geographical-regions
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI

Erzeugung

CIM-Model Generation.svg

Bezeichnung Typ Beschreibung
Asynchrongenerator topologisches Basiselement
http-Methode: GET
Bezeichnung: asynchronous-machines
aktuelle Version: 0
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Erzeugungsart Kategorisierung
http-Methode: GET
Bezeichnung: generation-types
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Kraftwerk Gruppierung
http-Methode: GET
Bezeichnung: plants
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
nicht-rotierende Energiequelle topologisches Basiselement
http-Methode: GET
Bezeichnung: non-rotating-energies
aktuelle Version: 0
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Synchrongenerator topologisches Basiselement
http-Methode: GET
Bezeichnung: synchronous-machines
aktuelle Version: 0
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Windkraftanlage (Typ 3 oder 4) topologisches Basiselement
http-Methode: GET
Bezeichnung: wind-turbines-type-3-or-4
aktuelle Version: 0
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI

Leitungen und Leitungselemente

CIM-Model Line.svg

Bezeichnung Typ Beschreibung
Leitung Gruppierung
http-Methode: GET
Bezeichnung: lines
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Leitungsabschnitt topologisches Basiselement
http-Methode: GET
Bezeichnung: ac-line-segments
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Leitungsart Kategorisierung
http-Methode: GET
Bezeichnung: line-types
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Muffe topologisches Basiselement
http-Methode: GET
Bezeichnung: junctions
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI

Messung

Bezeichnung Beschreibung
aktuelle Wirkleistung
http-Methode: GET
Bezeichnung: active-power
aktuelle Version: 0
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Messeinrichtung (aktuelle Wirkleistung)
http-Methode: GET
Bezeichnung: active-power-measurements
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI

Umspannwerk

CIM-Model Substation.svg

Bezeichnung Typ Beschreibung
Feld Gruppierung
http-Methode: GET
Bezeichnung: bays
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Lastgangschalter topologisches Basiselement
http-Methode: GET
Bezeichnung: load-break-switches
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Leistungsschalter topologisches Basiselement
http-Methode: GET
Bezeichnung: breakers
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Spannungsebene Gruppierung
http-Methode: GET
Bezeichnung: voltage-levels
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Sammelschiene topologisches Basiselement
http-Methode: GET
Bezeichnung: busbar-sections
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Transformator topologisches Basiselement
http-Methode: GET
Bezeichnung: power-transformers
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Trenner topologisches Basiselement
http-Methode: GET
Bezeichnung: disconnectors
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Umspannwerk Gruppierung
http-Methode: GET
Bezeichnung: substations
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Umspannwerkart Kategorisierung
http-Methode: GET
Bezeichnung: substation-types
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI

Verbrauch

CIM-Model Load.svg

Bezeichnung Typ Beschreibung
Lasten mit Standardlastprofil topologisches Basiselement
http-Methode: GET
Bezeichnung: conform-loads
aktuelle Version: 0
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Lasten ohne Standardlastprofil topologisches Basiselement
http-Methode: GET
Bezeichnung: non-conform-loads
aktuelle Version: 0
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Lasttyp Kategorisierung
http-Methode: GET
Bezeichnung: load-types
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Standardlastprofilart Kategorisierung
http-Methode: GET
Bezeichnung: conform-load-types
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI

Anlagenstammdaten

Bezeichnung Beschreibung
Anlagen
http-Methode: GET
Bezeichnung: assets
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Anlagenbetreiber
http-Methode: GET
Bezeichnung: asset-owners
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Aufteilungen und Zuordnungen des Anlagenbetriebs
http-Methode: GET
Bezeichnung: ownerships
aktuelle Version: 1
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Anlagenstandort
http-Methode: GET
Bezeichnung: asset-locations
aktuelle Version: 0
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI
Anlagenverantwortlicher
http-Methode: GET
Bezeichnung: asset-operators
aktuelle Version: 0
Sprache (ISO 639-1): {{{language}}}
Quelltext: api.openk.de
Spezifikation: Swagger UI

Kursiver Text

Abgerufen von „http://wiki.openkonsequenz.de/index.php?title=Domänen-API&oldid=425“