All die Parameter Unterklassen in Pywr stammen von einer gemeinsamen Basisklasse ab.

Allgemeine Beschreibung

Ein einfacher Parameter, der einen konstanten Wert definiert. API Referenz

Attribute

Beispiel

{
    Typ: 'konstanter Parameter',
    Wert: 123
}

Allgemeine Beschreibung

Initialisiere dich selbst. Eine genaue Signatur finden Sie in der Hilfe (type (self)). API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Basisparameter, der eine bereitstellt indizieren Methode. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Eine Sammlung von IndexParameters

Diese Klasse verhält sich wie ein Set. Parameter können hinzugefügt oder daraus entfernt werden. Sein Index ist der Index seiner untergeordneten Parameter, der mithilfe einer Aggregationsfunktion (z. B. Summe) aggregiert wird.

Attribute

Beispiel

kommt bald...

Allgemeine Beschreibung

Ein szenariovariierender Parameter. Die Werte in diesem Parameter sind zeitlich konstant, variieren jedoch innerhalb eines einzelnen Szenarios.

Attribute

Größe

Beispiel

kommt bald...

description: Eine Übersicht der Pywar-Parameter, die von WaterStrategy unterstützt werden

Parameter

Parameter sind Funktionen, die bei jedem Zeitschritt einen Wert im Modell zurückgeben. Bei diesen Werten kann es sich um eine Konstante handeln, die auf der Zeit (z. B. auf dem Tag oder Monat) basiert, um eine Berechnung, die auf dem Reservoirspeicher des Zeitschritts basiert, und um viele andere Berechnungen. Benutzerdefinierte Parameter können auch in Python geschrieben werden.

Diese Seite beschreibt (die meisten) der von Pywr unterstützten Parametertypen. Eine Übersicht der Parameter in Pywr finden Sie . Die vollständige Liste der integrierten Pywr-Parameter finden Sie .

1. Einen Parameter erstellen

Klicken Sie in einem Netzwerk auf die Registerkarte „Parameter“:

Klicken Sie neben dem Abschnitt „Kategorien für Parametertypen“ auf die Schaltfläche „+“ und wählen Sie „PYWR\ _PARAMETER“.

Eine Texteingabe erscheint. Geben Sie den Namen Ihres Parameters ein:\

Ändern Sie den Parameter nach Bedarf im bereitgestellten JSON-Editor:

2. Parameter-Editoren in WaterStrategy

Um das Ändern von Parametern zu vereinfachen, bietet WaterStrategy Editoren für häufig verwendete Parameter, wie z. B. monatliche Profilparameter, mit vorab ausgefüllten Standardwerten und grafische Editoren, um die Eingabe von Daten zu vereinfachen.

Beispiel für einen Parameter-Editor

Wählen Sie auf der Registerkarte „Parameter“ beim Hinzufügen eines neuen Parameters „PYWR“ aus._PARAMETER_MONATLICH\ _PROFILE' wie abgebildet:\

Beachten Sie, dass der angezeigte Editor eine JSON-Registerkarte, aber auch eine Registerkarte Zeichnen und Tabelle anzeigt. Wenn Sie die Daten in der Tabelle ändern, werden die Daten in der JSON-Datei automatisch aktualisiert, wie hier gezeigt:\

Durch diese Änderungen wird das JSON automatisch aktualisiert:

Allgemeine Beschreibung

Ein Szenario, das IndexParameter variiert. Die Werte in diesem Parameter sind zeitlich konstant, variieren jedoch innerhalb eines einzelnen Szenarios.

Attribute

Beispiel

kommt bald...

Allgemeine Beschreibung

Parameter, der einen Negativwert eines anderen annimmt Parameter.

Attribute

Größe

Beispiel

kommt bald...

Allgemeine Beschreibung

Parameter, der einen teilt Parameter von einem anderen.

Attribute

Beispiel

kommt bald...

Allgemeine Beschreibung

Parameter, der einen anderen ausgleicht Parameter um einen konstanten Wert.

Diese Klasse ist eine effizientere Version von Aggregierter Parameter wo ein Single Parameter wird durch einen konstanten Wert ausgeglichen. API Referenz

Attribute

Größe (obere)._Grenzen

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Parameter, der mindestens das Negative von a annimmt Parameter und konstanter Wert (Schwellenwert). API Referenz

Attribute

Größe

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Eine Sammlung von IndexParameters. Diese Klasse verhält sich wie ein Set. Parameter können hinzugefügt oder daraus entfernt werden. Sein Wert ist der Wert seiner untergeordneten Parameter, der mithilfe einer Aggregationsfunktion (z. B. Summe) aggregiert wird. API Referenz

Attribute

Beispiel

{
	„type“: „AggregatedParameter“,
	„agg_func“: „Produkt“,
	„Parameter“: [
		„Grundnachfrage“,
		„Nachfragefaktor der Kontrollkurve“
	]
}

In diesem Fall multipliziert der aggregierte Parameter zwei Parameter miteinander.

• Grundnachfrage

• Nachfragefaktor der Kontrollkurve

Dieses Beispiel zeigt, wie ein Basisbedarf mit einem Faktor multipliziert wird, der den Bedarf auf der Grundlage einer Reservoirsteuerungskurve reduziert. Sie können auf jeden dieser Parameter klicken, um zu sehen, wie sie definiert sind.

Allgemeine Beschreibung

Parameter, der das Maximum eines anderen annimmt Parameter und konstanter Wert (Schwellenwert).

Diese Klasse ist eine effizientere Version von Aggregierter Parameter wo ein Single Parameter wird mit einem konstanten Wert verglichen. API Referenz

Attribute

Größe

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Parameter, der mindestens einen anderen benötigt Parameter und konstanter Wert (Schwellenwert).

Diese Klasse ist eine effizientere Version von Aggregierter Parameter wo ein Single Parameter wird mit einem konstanten Wert verglichen. API Referenz

Attribute

Größe

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Parameter, der das Maximum des Negativen von a annimmt Parameter und konstanter Wert (Schwellenwert). API Referenz

Attribute

Größe

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Das wöchentliches Profil enthält 52 Wochen pro Jahr. Die letzte Woche des Jahres hat mehr als 7 Tage, da 365/7 nicht ganz ist. API Referenz

Attribute

Beispiel

{
    Typ: 'Wochenprofil',
    Werte: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1...]
}

Allgemeine Beschreibung

Parameter, der einen gleichmäßig reduzierenden Wert von Eins auf Null bereitstellt.

Dieser Parameter ist für die Verwendung mit einem Jährlicher virtueller Speicher Knoten, um ein Profil bereitzustellen, das die perfekte durchschnittliche Auslastung des Jahresvolumens darstellt. Am Reset-Tag wird der Wert 1 zurückgegeben und anschließend jeden Tag danach um 1/366 reduziert. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Parameter, der ein monatliches Profil pro Szenario bereitstellt.

Das Verhalten ist dasselbe wie Monatlicher Profilparameter außer dass für jedes Ensemble in einem bestimmten Szenario ein anderes Profil zurückgegeben wird. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Zeitvariierender Parameter unter Verwendung eines Arrays und TimeStep.Index

Die Werte in diesem Parameter sind in allen Szenarien konstant. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Parameter, der ein Tagesprofil mithilfe einer radialen Basisfunktion (RBF) interpoliert.

Das Tagesprofil wird während des Modells berechnet zurücksetzen unter Verwendung einer radialen Basisfunktion mit dem Tag des Jahres als unabhängigen Variablen. Die Tage des Jahres werden vom Benutzer zusammen mit den Werten definiert, die an jedem dieser Tage für die Interpolation verwendet werden sollen. Der erste Tag der Jahre sollte immer eins sein, und sein Wert wird als 366. Wert wiederholt. Darüber hinaus werden der zweite und der vorletzte Wert gespiegelt, damit ein konsistenter Gradient über die Grenze hinweg entsteht. Die RBF-Berechnungen erfolgen unter Verwendung von scipy.interpolate.rbf Objekt, weitere Informationen finden Sie in der Dokumentation von Scipy. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Parameter, der einen IndexParameter verwendet, um ein Array von Parametern zu indizieren.

Ein Beispiel für die Verwendung dieses Parameters besteht darin, einen Bedarfseinsparfaktor (als Float) zurückzugeben, der auf dem aktuellen Bedarfseinsparniveau basiert (berechnet durch Indexparameter). API Referenz

Attribute

Beispiel

{
	„Typ“: „indexedarrayparameter“,
	„index_parameter“: „Reservoir-Kontrollkurve“,
	„Parameter“: [
		1,
		0.9,
		0.8,
		0.5
	]
}

Der obige Code verwendet den Index, der durch den Parameter „Reservoir control curve“ bereitgestellt wird, was ein Parameter für den Steuerkurvenindex. Index 0 gibt eine 1 zurück, Index 2 gibt 0.9 zurück usw...

In diesem Beispiel wird dieser Parameter verwendet, um einen Bedarf auf der Grundlage einer Reservoirsteuerkurve zu reduzieren. Bitte gehen Sie zum Beispiel für einen aggregierten Parameter um zu sehen, wie das gemacht wird.

Bitte sehen Sie, wie der Parameter Reservoir-Kontrollkurve definiert ist.

Allgemeine Beschreibung

Zeitvariierender Parameter unter Verwendung eines Arrays und TimeStep.Index mit multiplikativen Faktoren pro Szenario.

Werte sind die grundlegenden Zeitreihendaten, die durch einen Faktor gestört werden. Der Faktor wird aus Faktoren abgeleitet, bei denen es sich um eine Form handelt (scenario.size, 12). Daher variieren die Faktoren in den einzelnen Szenarien in Szenario und Monat. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Parameter, der ein Tagesprofil pro Szenario liefert.

Dieser Parameter liefert ein sich wiederholendes Jahresprofil mit einer täglichen Auflösung. Für jedes Mitglied eines bestimmten Szenarios wird ein anderes Profil zurückgegeben. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Parameter, der ein wöchentliches Profil pro Szenario bereitstellt

Dieser Parameter liefert ein sich wiederholendes Jahresprofil mit einer wöchentlichen Auflösung. Für jedes Mitglied eines bestimmten Szenarios wird ein anderes Profil zurückgegeben. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Ein szenariovariierender Parameter.

Die Werte in diesem Parameter variieren je nach Index in der Zeit und variieren innerhalb eines einzelnen Szenarios. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Gibt einen von zwei Werten zurück, die von einem Recorder-Wert und einem Schwellenwert abhängen. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Gibt je nach Jahr des aktuellen Zeitschritts einen von zwei Werten zurück. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Gibt je nach Wert eines Parameters einen von zwei Werten zurück. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Gibt einen von zwei Werten zurück, die vom vorherigen Fluss in einem Knoten abhängen. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Der Parameterwert entspricht der Interpolation eines anderen Parameters. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Basisklasse für Parameter, die je nach Zustand einen von zwei Werten zurückgeben. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Gibt je nach aktuellem Volumen einen von zwei Werten in einem Storage node zurück. API Referenz

Attribute

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Basisklasse für alle Parameter, die darauf angewiesen sind, dass der angehängte Knoten ein Steuerelement enthält_Kurvenparameter. [API Referenz] (https://pywr.github.io/pywr-docs/master/api/generated/pywr.parameters.control_Curves.BaseControlCurveParameter.html #pywr .parameters.control\ _curves.BaseControlCurveParameter)

Attribute

node .

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Der Parameterwert entspricht der Quadratur der Interpolation eines anderen Parameters. API Referenz

Attribute

, , Interpolation, optional, niedriger

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Ein Kontrollkurvenparameter, der zwischen drei oder mehr Werten interpoliert.

Die Rückgabewerte werden linear zwischen den Steuerkurven interpoliert, wobei der erste und der letzte Wert 100% bzw. 0% sind. API Referenz

Attribute

node .

Beispiel

kommt bald...

{

}

Allgemeine Beschreibung

Ein Kontrollkurvenparameter, der zwischen zwei oder mehr Wertepaaren interpoliert.

Rückgabewerte werden je nach aktuellem Speicher linear zwischen einem Wertepaar interpoliert. Das erste Paar wird zwischen dem Maximum und der ersten Steuerkurve verwendet, das nächste Paar zwischen der ersten Steuerkurve und der zweiten Steuerkurve usw., bis das letzte Paar zwischen der letzten Steuerkurve und dem Minimalwert verwendet wird. Der erste Wert in jedem Paar ist der Wert an der oberen Position und der zweite der Wert an der unteren Position. API Referenz

Attribute

Beispiel

kommt bald...

{

}

layout: description: visible: false outline: visible: true pagination: visible: true tableOfContents: visible: true title: visible: true

Interpolationsparameter

Allgemeine Beschreibung

Generischer Interpolationsparameter, der einen Wert zurückgibt, der auf dem aktuellen Volumen (Zeitschritt) eines Reservoirs oder eines Storage-Knotens basiert. Der

parameter verwendet eine Reihe (Tabelle) von Volumen des Reservoirs und entsprechende Werte. In diesem Fall sind die zugehörigen Werte die entsprechenden Gebiet des Stausees für eine bestimmte Volumen.

Interpolation wird verwendet, um Werte zwischen Punkten zu berechnen, die im Interpolationsfeld angegeben sind. API Referenz

Attribute

Beispiel

Das folgende Json zeigt ein Beispiel für eine Härtung mit der Bewertung von Fläche und Volumen für ein Reservoir. Dies könnte verwendet werden, um das Area-Attribut eines Speicher- oder Reservoir-Knotens zu definieren.

{
  „type“: „InterpolatedVolumeParameter“,
  „node“: „Reservoir oder Storage node Name“,
	„Bände“: [
		0,
		7,
		10,
		15,
		25
	],
	„Werte“: [
		1,
		2,
		4,
		6,
		14
	],

	„interp_kwargs“: {
		„kind“: „linear“
	},
  „Kommentar“: „Volumen: Mm3, Werte: Km2"
}

Das Json steht für die folgende Tabelle:

Wenn es geplottet ist, sieht es so aus:

Unten finden Sie ein Beispiel für eine Gebietsbewertungstabelle

Wenn es geplottet ist, sieht es so aus

Allgemeine Beschreibung

Zeitreihenparameter mit automatischer Ausrichtung und Resampling. API Referenz

Attribute

Beispiel

{
	„Typ“: „DataFrameParameter“,
	„url“: „Zuflüsse_mm3_day.csv „,
	„column“: „Einzugsgebiet Fluss 1",
	„index_col“: „Zeitschritt“,
	„parse_dates“: wahr
}

Allgemeine Beschreibung

Dieser Parameter liest Array-Daten aus einer PyTables HDF-Datenbank.

Der Parameter liest Daten über die PyTables-Array-Schnittstelle und erfordert daher nicht das Laden des gesamten Datensatzes in den Speicher. Dies ist für große Modellläufe nützlich. API Referenz

Durch das Speichern von HDF5-Dateien im „festen“ Format können Benutzer optimale Datenzugriffsgeschwindigkeiten erreichen, was HDF5 zu einem effektiven Tool für PYWR-Szenarien macht, die DataFrames als Parameter verwenden, bei denen ein schneller Datenabruf entscheidend ist. HDF5-Dateien werden als Wörterbuch gelesen, wobei jeder Schlüssel einen Pandas-DataFrame darstellt. Beispielsweise könnte die Struktur einer inflows.h5-Datei drei Schlüssel enthalten, die jeweils für einen anderen Fluss stehen. Jeder Schlüssel enthält drei Zeitreihen, die einem Pywr-Szenario der Größe 3 zugewiesen werden können.

Wenn Sie den h5-Datei-DataFrame zum Ausführen von Pywr-Szenarien verwenden, lesen Sie bitte um diese Funktion zu aktivieren

Hinweis: Die Größe der Pywr-Szenarien muss der Anzahl der Schlüssel in der h5-Datei entsprechen

Attribute

Beispiel

{
	„key“: „Einzugsgebiet Fluss 1",
	„scenario“: „Klimawandel“,
	„Typ“: „DataFrameParameter“,
	„url“: „inflows.h5",
	„index_col“: „Zeitschritt“,
	„parse_dates“: wahr
}

Allgemeine Beschreibung

Gibt einen von zwei Werten zurück, die von der Ordinalzahl des aktuellen Zeitschritts abhängen.

Attribute

Beispiel

kommt bald...

Beispiel

Der obige Code definiert 3 Reservoir-Steuerkurven für das Reservoir mit dem Namen „Reservoirname“. Er gibt einen Index zurück, der davon abhängt, wie voll das Reservoir ist:

Allgemeine Beschreibung

EIN Parameter was den Wert einer jährlichen harmonischen Reihe zurückgibt.

Das Parameter umfasst eine Kosinusfunktion der Reihe N mit einer Periode von 365 Tagen. Für die Berechnung wird der Julientag des Jahres minus 1 verwendet. Dies führt zu einer kleinen Diskontinuität in Jahren, die keine Schaltjahre sind.

$f (t) =A+%n=1nA·cos (2⁄nt) /365+n) $

Attribute

Beispiel

kommt bald...

Allgemeine Beschreibung

Parameter, der den Fluss von einem Knoten aus dem vorherigen Zeitschritt bereitstellt.

Hinweise: Dieser Parameter verfolgt den Ablauf des vorherigen Zeitschritts auf dem angegebenen Knoten. Diese Werte können in Berechnungen für den aktuellen Zeitschritt verwendet werden, als ob es sich um einen beliebigen anderen Parameter handeln würde.

Attribute

Beispiel

kommt bald...

Allgemeine Beschreibung

Parameter, der den aktuellen Rabattfaktor auf der Grundlage des Rabattsatzes und eines Basisjahres zurückgibt.

Attribute

Beispiel

kommt bald...

Allgemeine Beschreibung

Parameter, der eine stückweise Funktion integriert.

Dieser Parameter berechnet das Integral einer stückweisen Funktion. Die stückweise Funktion wird als zwei Arrays angegeben (x und y) und es wird angenommen, dass es bei (0, 0) beginnt. Die Werte von x sollte monoton ansteigend und größer als Null sein.

Attribute

Beispiel

kommt bald...

Allgemeine Beschreibung

Generischer Interpolationsparameter, der den Fluss eines Knotens im vorherigen Zeitschritt für die Interpolation verwendet.

Attribute

Beispiel

kommt bald...

Allgemeine Beschreibung

Das Zielparameter Wasserkraft ist ein Parameter, der den Durchfluss aus einem Ziel zur Erzeugung von Wasserkraft zurückgibt. Dieser Parameter berechnet den Durchfluss, der erforderlich ist, um ein bestimmtes Ziel für die Erzeugung von Wasserkraft zu erreichen. Er ist für den Einsatz an einem Knoten vorgesehen, der eine Turbine darstellt, wo für jeden Zeitschritt ein bestimmtes Produktionsziel erforderlich ist.

Attribute

Maximum_fließen

Beispiel

Allgemeine Beschreibung

Parameter, der in jedem Szenario-Ensemble einen anderen untergeordneten Parameter verwendet.

Dieser Parameter wird verwendet, um zwischen verschiedenen untergeordneten Parametern zu wechseln, die auf verschiedenen Ensembles in einer bestimmten Gruppe basieren. Szenario. Es kann verwendet werden, um Daten in einem Parametertyp, der nicht szenariospezifisch ist, über mehrere Szenarioensembles hinweg zu variieren. Beispielsweise unterstützen viele der Kontrollkurven- oder Interpolationsparameter Szenarien nicht explizit. Dieser Parameter kann verwendet werden, um mehrere Kontrollkurvendefinitionen im Rahmen einer einzigen Simulation zu testen.

Attribute

Beispiel

kommt bald...

Allgemeine Beschreibung

Parameter, der den verzögerten Fluss für einen Knoten nach einer bestimmten Anzahl von Zeitschritten oder Tagen zurückgibt.

Attribute

Beispiel

kommt bald...

Allgemeine Beschreibung

Parameter, der ein Tagesprofil liefert.

Das Tagesprofil gibt einen anderen Wert zurück, der auf dem Monat des aktuellen Zeitschritts basiert. API Referenz

Attribute

Beispiel

{
    Typ: 'Tagesprofil',
    Werte: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1...]
}

Allgemeine Beschreibung

Parameter, der ein monatliches Profil bereitstellt. Das Monatsprofil gibt einen anderen Wert zurück, der auf dem Monat des aktuellen Zeitschritts basiert. API Referenz

Attribute

Beispiel

{
    Typ: 'monatliches Profil',
    Werte: [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1]
}

Water Strategy bietet eine alternative Möglichkeit, mit Monatsprofilen zu arbeiten.

Allgemeine Beschreibung

Parameter verfolgen das Defizit (max\ _flow - tatsächlicher Fluss) eines Knotens. API Referenz

Hinweise: Dieser Parameter ist insofern etwas ungewöhnlich, als sein Wert während der After-Methode berechnet wird, nicht bei calc_Werte. Es soll in Kombination mit einem Rekorder (z. B. numpyArrayNodeRecorder) verwendet werden, um das Defizit (definiert als angefragt - aktueller Fluss) an einem Knoten aufzuzeichnen. Beachten Sie, dass dies bedeutet, dass die Aufzeichnung dieses Parameters nicht gibt Ihnen den Wert, der vom Solver in diesem Zeitschritt verwendet wurde. Alternativ kann dieser Parameter im Modell zusammen mit anderen Parametern verwendet werden und wird wie folgt ausgewertet _Defizit von gestern, wobei das Defizit im nullten Zeitschritt Null ist.

Attribute

Beispiel

kommt bald...

{

}