KTR-Datei: Unterschied zwischen den Versionen

Version vom 16. Oktober 2023, 14:59 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: Funktionstyp (wenn Steuerungstyp F, muss er identisch mit dem Funktionstyp in der FKT-Datei sein. Bei anderen Steuerungstypen sollte er immer 0 sein!
G: Control-type [A,F,B,C,P]
- 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: Kontrollwasserstandsanzeiger

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: ???
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
- 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)
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]
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 127: / Zeile 127: @@
 ** <code>'''A1'''</code>: Beschriftung x-Achse
 ** <code>'''A2'''</code>: Beschriftung y-Achse
-* '''Werte Änderung'''
+* '''Werte Änderung''': bestimmt wie oft der Funktionswert aktualisiert werden soll
 ** <code>'''N1'''</code>: Kennung [0-3]
-*** <code>0</code>: <span style="color:red">???</span>'''
+*** <code>0</code>: in jedem Zeitschritt (Standard)
-*** <code>1</code>: <span style="color:red">???</span>'''
+*** <code>1</code>: nur nach Ablauf eines festen Zeitintervalls
-*** <code>2</code>: <span style="color:red">???</span>'''
+*** <code>2</code>: Steuerung über Tages-/Wochen-/Jahresgänge (wenn das Produkt aller angegebenen Gänge > 0.0 ist)
-*** <code>3</code>: <span style="color:red">???</span>'''
+*** <code>3</code>: in Abhängigkeit eines Kontrollzustandes <span style="color:red">(noch nicht implementiert)</span>
-* <code>'''T1'''</code>: Typ <span style="color:red">???</span>
+* <code>'''T1'''</code>: Zeitintervall Typ:
-* <code>'''F1'''</code>: Faktor <span style="color:red">???</span>
+** <code>1</code>: Jahre
+** <code>2</code>: Monate
+** <code>3</code>: Wochen
+** <code>4</code>: Tage
+** <code>5</code>: Stunden
+** <code>6</code>: Minuten
+* <code>'''F1'''</code>: Anzahl Zeitintervalle
 * <code>'''D1'''</code>: Bezugsdatum <code>[TT.MM.JJJ hh:mm]</code>
-* <code>'''G1'''</code>: <span style="color:red">???</span>'''
+* <code>'''G1'''</code>: Jahresgang-ID (siehe [[JGG-Datei]])
-* <code>'''G2'''</code>: <span style="color:red">???</span>'''
+* <code>'''G2'''</code>: Wochengang-ID (siehe [[WGG-Datei]])
-* <code>'''G3'''</code>: <span style="color:red">???</span>'''
+* <code>'''G3'''</code>: Tagesgang-ID (siehe [[TGG-Datei]])
 ===Kontroll-Gruppen=== <!--T:36-->