KTR-Datei: Unterschied zwischen den Versionen

Aktuelle Version vom 26. April 2024, 10:34 Uhr

Die KTR-Datei enthält Angaben zu den Kontrollfunktionen

Beispiel

*Kontrollfunktionen (*.KTR)
*==========================
[SETTINGS]
VERSION=1.4

*Kontrolltypen:  Typ: A = Aktuelle Systemzustaende
*                     B = Bilanzen (Abweichungen vom Sollwert)
*                     C = Bilanzen (aktuelle Systemzustaende)
*                     P = Pegel

*|--------|----|-------|---|-----|-----------|---|-----|----------------|----------------|-------------------------------------|-----------------------|-----------------------|------------------------------|--------------------------------------------|
*| Bez.   |KTR | Funkt.|KTR| Sys-| 1.KTR     |WEL|Stoff|   Settings     | S O L L W E R T|             I S T W E R T           |    Min / Max Werte    |      Koordinaten      |      ACHSENBESCHRIFTUNG      |        W E R T E   A E N D E R U N G       |
*|      an|Kng | S Z A |Typ|zust.|Z Kng  Fak |   | Kng |F I E T         |    Wert    JGG | Kng |Zschr|fest.Zeitraum|Monat|XZsch|Use    Groups only     |                       |                              |Kng|Intervall    Bezugsdatum   | konst.Gang |
*|--------|----|-------|---|-----|-----------|---|-----|----------------|----------------|-----|--1--|------2------|--3--|--4--|-----------------------|-----------------------|------------------------------|---|-----------(1)-------------|----(2)-----|
*|        |    |       |   |     |           |   |(KTR)|J J J J         |   Tsd.m3       | 1-4 | max.| Start  Ende | dt= | max.|J     Constraints      | Kontrollgruppenfenster|    X-Achse        Y-Achse    |0-3|Typ Faktor   Bezugsdatum   |JGG WGG TGG |
*|     J/N|    | J/N i |   |     |           |   |     |N N N N         |  m3/s, mm   -  |     | 7200| tt.mm tt.mm |Monat| 7200|N    Min       Max     |      x         y      |                              |   |                           |            |
*|-<-->-+-|<-->|-+-+-+-|-+-|-<->-|++<--><--->|-+-|-<-->|+-+-+-+------->-|-<-------->-<->-|-<->-|<--->|-++.++-++.++-|-----|<--->|+<-------->-<-------->-|-<-------->-<-------->-|<-------------><------------->|<->|<->-<---->-TT.MM.JJJJ hh:mm|<->-<->-<->-|
*|  A   B | C  | D E F | G |  H  | I  J   K  | L |  M  |        N       |     O       P  |  Q  |  R  |   S     T   |  U  |  W  |X     Y         Z      |     K1         K2     |<      A1             A2      | N1| T1   F1      D1           | G1  G2  G3 |

 | A011 J |y001| J N 0 | A | 1AB |           | N |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N         0          0 |   15348.18   6267.731 |                              | 0 | 4       1|01.01.1990      |            |Outflow_1
 | A012 J |y002| J N 3 | A | 1AB |           | N |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N         0          0 |   15334.15   6478.159 |                              | 0 | 4       1|01.01.1990      |            |Outflow_1
 | A013 J |y003| J N 0 | A | 1AB |           | N |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N         0          0 |   15318.12   6733.678 |                              | 0 | 4       1|01.01.1990      |            |Outflow_1
 | A014 J |y004| J N 0 | A | 1AB |           | N |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N         0          0 |   15318.12   6974.167 |                              | 0 | 4       1|01.01.1990      |            |Outflow_1
 | A015 J |y005| J N 0 | A | 1AB |           | N |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N         0          0 |   15348.18   7395.021 |                              | 0 | 4       1|01.01.1990      |            |Outflow_1
 | A016 J |y006| J N 0 | A | 1AB |           | N |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N         0          0 |   15348.18   7605.449 |                              | 0 | 4       1|01.01.1990      |            |Outflow_1
 | A018 J |y007| J N 0 | A | 1AB |           | N |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N         0          0 |   13468.36   2720.526 |                              | 0 | 4       1|01.01.1990      |            |Outflow_1


*Kontrollgruppen: KGRP: Z = Zusammenfassung verschiedener Kontrollfunktionen
*                 Wert: 1 : Kontrolliert IST  - Wert
*                       2 : Kontrolliert FAKTOR - Wert

*|--------|----|-------|---|-----|-----------|---|-----|----------------|----------------|-------------------------------------|-----------------------|-----------------------|------------------------------|--------------------------------------------|
*| Bez.   |KTR | Funkt.|KTR| Sys-| 1.KTR     |WEL|Stoff|   Settings     | S O L L W E R T|             I S T W E R T           |    Min / Max Werte    |      Koordinaten      |      ACHSENBESCHRIFTUNG      |        W E R T E   A E N D E R U N G       |
*|      an|Kng | S Z A |Typ|zust.|Z Kng  Fak |   | Kng |F I E T         |    Wert    JGG | Kng |Zschr|fest.Zeitraum|Monat|XZsch|Use    Groups only     |                       |                              |Kng|Intervall    Bezugsdatum   | konst.Gang |
*|--------|----|-------|---|-----|-----------|---|-----|----------------|----------------|-----|--1--|------2------|--3--|--4--|-----------------------|-----------------------|------------------------------|---|-----------(1)-------------|----(2)-----|
*|        |    |       |   |     |           |   |(KTR)|J J J J         |   Tsd.m3       | 1-4 | max.| Start  Ende | dt= | max.|J     Constraints      | Kontrollgruppenfenster|    X-Achse        Y-Achse    |0-3|Typ Faktor   Bezugsdatum   |JGG WGG TGG |
*|     J/N|    | J/N i |   |     |           |   |     |N N N N         |  m3/s, mm   -  |     | 7200| tt.mm tt.mm |Monat| 7200|N    Min       Max     |      x         y      |                              |   |                           |            |
*|-<-->-+-|<-->|-+-+-+-|-+-|-<->-|++<--><--->|-+-|-<-->|+-+-+-+------->-|-<-------->-<->-|-<->-|<--->|-++.++-++.++-|-----|<--->|+<-------->-<-------->-|-<-------->-<-------->-|<-------------><------------->|<->|<->-<---->-TT.MM.JJJJ hh:mm|<->-<->-<->-|
*|  A   B | C  | D E F | G |  H  | I  J   K  | L |  M  |        N       |     O       P  |  Q  |  R  |   S     T   |  U  |  W  |X     Y         Z      |     K1         K2     |<      A1             A2      | N1| T1   F1      D1           | G1  G2  G3 |

 | KGRP J |y026| J N 3 | F |     |+ y021    1| J |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N        10         10 |   7800.846   676.3739 |                              | 0 | 4       1|01.01.1990      |            |IBR_KB
 | KGRP J |y027| J N 3 | F |     |+ y022    1| N |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N        10         10 |   9755.816   195.3969 |                              | 0 | 4       1|01.01.1990      |            |IBR_LM
 | KGRP J |y028| J N 3 | F |     |+ y007    1| N |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N        10         10 |   9243.776   2720.526 |                              | 0 | 4       1|01.01.1990      |            |Qa_Flaje<75l/s
 | KGRP J |y029| J N 3 | F |     |+ y023    1| N |     |J N J N         |                |  1  |  1  |             |xxxxx|     |N        10         10 |   7426.084   5891.968 |                              | 0 | 4       1|01.01.1990      |            |Qz_TS_LM <>30l/s
 | KGRP J |y030| J N 3 | F |     |+ y026    1| J |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N        10         10 |    5607.39   646.3128 |                              | 0 | 4       1|01.01.1990      |            |IBR(KB) < 11,2
 | KGRP J |y031| J N 3 | A |     |+ y001    1| N |     |N N J N         |                |  1  |  1  |             |xxxxx|     |N        10         10 |   11802.97   6628.464 |                              | 0 | 4       1|01.01.1990      |            |Qz,net_TS_KB_A11/12/13/14

*|--------|----|-------|---|-----|-----------|---|-----|----------------|----------------|-----|--1--|------2------|--3--|--4--|-----------------------|-----------------------|------------------------------|---|-----------(1)-------------|----(2)-----|

Erläuterungen

Kontrollfunktionen

A: ID des Elements, von dem ein Systemzustand aufgerufen werden soll
B: Kontrollfunktion aktiviert/deaktiviert? [J/N] J = Ja, N = Nein
C: Eindeutige ID der Steuerfunktion (muss mit y beginnen!)
D: Interpolation zwischen Stützpunkten [J/N]
E: Interpolation in der Zeit [J/N]
F: Funktionsart (wenn Steuerungstyp F, muss er identisch mit der Funktionsart in der FKT-Datei sein. Bei anderen Steuerungstypen sollte er immer 0 sein!
G: Steuerungstyp [A,F,B,C,P,S]
- A: aktueller Zustand
- F: Funktion (in diesem Fall muss die Funktion in der FKT-Datei definiert sein!)
- B: Bilanz mit Ziel/Referenz
- C: Bilanz ohne Ziel/Referenz
- P: Kontrollpegel
- S: Summe (kann durch die Definition einer "Werte-Änderung" (siehe unten) periodisch wieder auf 0 zurückgesetzt werden)

H: Systemzustand ( verschiedene Möglichkeiten je nach Elementtyp, z.B. 1AB, 1ZU. Bei einem Staudamm auch VOL, WSP oder die Kennzeichnung der Steuer-/Lenkfunktion)
I, J, K: nur relevant für Kontrollgruppen (siehe unten)

L: Ausgabe der Ganglinie in einer KTR.WEL-Datei [J/N]
M: ???
N: Settings, jeweils mit J/N einstellbar:
- F: ???
- I: Iteration: Wenn J, wird die Kontrollfunktion am Ende jedes Zeitschritts nochmal abschließend berechnet.
- E: ???
- T: Use time step: Wenn J, wird die Kontrollfunktion mit dem eingestellten Simulationszeitschritt [s] multipliziert. Die Option ist nur beim Steuerungstyp Summe wirksam.
Sollwert (nur erforderlich, wenn Steuerungstyp B)
- O: Sollwert [Tsd m³; m³, mm]
- P: Jahresgang des Sollwerts
Istwert (nur relevant, wenn Steuerungstyp B und/oder C)
- Q: Berechnungsart des Ist-Wertes/aktuellen wertes: [1-4]
  - Berechnungsart 1: Mittelwert der letzten n Zeitschritte
    - R: Anzahl Zeitschritte
  - Berechnungsart 2: fester Zeithorizont
    - S: Beginn [TT.MM] [Tag.Monat]
    - T: Ende [TT.MM] [Tag.Monat]
  - Berechnungsart 3: fester Zeithorizont Monat
    - U: Wert ist nicht erforderlich, wird nicht importiert
  - Berechnungsart 4: i-ter Zeitschritt
    - - W: Nummer des Zeitschritts (1=letzter Zeitschritt vor dem aktuellen)
Min / Max Werte: (nur für Kontrollgruppen)
- X: Beschränkung auf Min/Max-Werte aktiv? [J/N]
- Y: Min-Wert: Wenn der Min-Wert unterschritten wird, ist das Ergebnis 0.
- Z: Max-Wert: Wenn der Max-Wert überschritten wird, ist das Ergebnis der Max-Wert.
Koordinaten
- K1: Kontrollgruppenfenster x-Wert
- K2: Kontrollgruppenfenster y-Wert
Achsenbeschriftung
- A1: Beschriftung x-Achse
- A2: Beschriftung y-Achse
Werte Änderung: bestimmt wie oft der Funktionswert aktualisiert werden soll (bzw. bei Steuerungstyp Summe, wann der Summenwert wieder auf 0 zurückgesetzt werden soll)
- N1: Kennung [0-3]
  - 0: in jedem Zeitschritt (Standard)
  - 1: nur nach Ablauf eines festen Zeitintervalls
  - 2: Steuerung über Tages-/Wochen-/Jahresgänge (wenn das Produkt aller angegebenen Gänge > 0.0 ist)
  - 3: in Abhängigkeit eines Kontrollzustandes (noch nicht implementiert)
- Zeitintervall (bei Kennung 1):
  - T1: Zeitintervall Typ:
    - 1: Jahre
    - 2: Monate
    - 3: Wochen
    - 4: Tage
    - 5: Stunden
    - 6: Minuten
  - F1: Anzahl Zeitintervalle
  - D1: Bezugsdatum [TT.MM.JJJ hh:mm]
- Tages-/Wochen-/Jahresgänge (bei Kennung 2):
  - G1: Jahresgang-ID (siehe JGG-Datei)
  - G2: Wochengang-ID (siehe WGG-Datei)
  - G3: Tagesgang-ID (siehe TGG-Datei)

Kontroll-Gruppen

wie Kontrollfunktionen, jedoch mit den folgenden Unterschieden:

A: ID der Kontrollgruppe (muss KGRP sein!)
H: nicht relevant für Kontrollgruppen
I: Berechnungsregeln für die Kombination von Kontrollfunktionen/Gruppen. Mögliche Operatoren sind: +, -, *, /, <, >, <=, >=
J: ID der Steuerfunktion, die verwendet werden soll (siehe C)
K: Multiplikator für diese Steuerfunktion

@@ Zeile 83: / Zeile 83: @@
 * <code>'''D'''</code>: Interpolation zwischen Stützpunkten [J/N]
 * <code>'''E'''</code>: Interpolation in der Zeit [J/N]
-* <code>'''F'''</code>: Funktionstyp (wenn Steuerungstyp F, muss er identisch mit dem Funktionstyp in der FKT-Datei sein. Bei anderen Steuerungstypen sollte er immer 0 sein!
+* <code>'''F'''</code>: Funktionsart (wenn Steuerungstyp F, muss er identisch mit der Funktionsart in der [[FKT-Datei]] sein. Bei anderen Steuerungstypen sollte er immer 0 sein!
-* <code>'''G'''</code>: KTR Typ [A,F,B,C,P,S]
+* <code>'''G'''</code>: Steuerungstyp [A,F,B,C,P,S]
 ** <code>A</code>: aktueller Zustand
 ** <code>F</code>: Funktion (in diesem Fall muss die Funktion in der FKT-Datei definiert sein!)
@@ Zeile 103: / Zeile 103: @@
 ** <code>I</code>: Iteration: Wenn <code>J</code>, wird die Kontrollfunktion am Ende jedes Zeitschritts nochmal abschließend berechnet.
 ** <code>E</code>: <span style="color:red">???</span>
-** <code>T</code>: <span style="color:red">???</span>
+** <code>T</code>: Use time step: Wenn <code>J</code>, wird die Kontrollfunktion mit dem eingestellten Simulationszeitschritt [s] multipliziert. Die Option ist nur beim Steuerungstyp Summe wirksam.
 * '''Sollwert''' (nur erforderlich, wenn Steuerungstyp B)
 ** <code>'''O'''</code>: Sollwert [Tsd m³; m³, mm]
@@ Zeile 128: / Zeile 128: @@
 ** <code>'''A1'''</code>: Beschriftung x-Achse
 ** <code>'''A2'''</code>: Beschriftung y-Achse
-* '''Werte Änderung''': bestimmt wie oft der Funktionswert aktualisiert werden soll
+* '''Werte Änderung''': bestimmt wie oft der Funktionswert aktualisiert werden soll (bzw. bei Steuerungstyp Summe, wann der Summenwert wieder auf 0 zurückgesetzt werden soll)
 ** <code>'''N1'''</code>: Kennung [0-3]
 *** <code>0</code>: in jedem Zeitschritt (Standard)
@@ Zeile 134: / Zeile 134: @@
 *** <code>2</code>: Steuerung über Tages-/Wochen-/Jahresgänge (wenn das Produkt aller angegebenen Gänge > 0.0 ist)
 *** <code>3</code>: in Abhängigkeit eines Kontrollzustandes <span style="color:red">(noch nicht implementiert)</span>
-* <code>'''T1'''</code>: Zeitintervall Typ:
+** Zeitintervall (bei Kennung 1):
-** <code>1</code>: Jahre
+*** <code>'''T1'''</code>: Zeitintervall Typ:
-** <code>2</code>: Monate
+**** <code>1</code>: Jahre
-** <code>3</code>: Wochen
+**** <code>2</code>: Monate
-** <code>4</code>: Tage
+**** <code>3</code>: Wochen
-** <code>5</code>: Stunden
+**** <code>4</code>: Tage
-** <code>6</code>: Minuten
+**** <code>5</code>: Stunden
-* <code>'''F1'''</code>: Anzahl Zeitintervalle
+**** <code>6</code>: Minuten
-* <code>'''D1'''</code>: Bezugsdatum <code>[TT.MM.JJJ hh:mm]</code>
+*** <code>'''F1'''</code>: Anzahl Zeitintervalle
-* <code>'''G1'''</code>: Jahresgang-ID (siehe [[JGG-Datei]])
+*** <code>'''D1'''</code>: Bezugsdatum <code>[TT.MM.JJJ hh:mm]</code>
-* <code>'''G2'''</code>: Wochengang-ID (siehe [[WGG-Datei]])
+** Tages-/Wochen-/Jahresgänge (bei Kennung 2):
-* <code>'''G3'''</code>: Tagesgang-ID (siehe [[TGG-Datei]])
+*** <code>'''G1'''</code>: Jahresgang-ID (siehe [[JGG-Datei]])
+*** <code>'''G2'''</code>: Wochengang-ID (siehe [[WGG-Datei]])
+*** <code>'''G3'''</code>: Tagesgang-ID (siehe [[TGG-Datei]])
 ===Kontroll-Gruppen=== <!--T:36-->