KTR-Datei: Unterschied zwischen den Versionen

Aus TALSIM Docs
(Diese Seite wurde zum Übersetzen freigegeben)
(Iteration dokumentiert (#117) und generelle Formatierung)
Zeile 75: Zeile 75:
==Erläuterungen== <!--T:12-->
==Erläuterungen== <!--T:12-->


 
===Kontrollfunktionen=== <!--T:13-->
===<code>Kontrollfunktionen</code>=== <!--T:13-->
 
 
====<code>Allgemein</code>==== <!--T:14-->


<!--T:15-->
<!--T:15-->
Zeile 97: Zeile 93:
<!--T:16-->
<!--T:16-->
* <code>'''H'''</code>: Systemzustand ( verschiedene Möglichkeiten je nach Elementtyp, z.B. 1AB, 1ZU. Bei einem Staudamm auch VOL, WSP oder die Kennzeichnung der Steuer-/Lenkfunktion)
* <code>'''H'''</code>: Systemzustand ( verschiedene Möglichkeiten je nach Elementtyp, z.B. 1AB, 1ZU. Bei einem Staudamm auch VOL, WSP oder die Kennzeichnung der Steuer-/Lenkfunktion)
* <code>'''I, J, K'''</code>: nur relevant für Kontrollgruppen
* <code>'''I, J, K'''</code>: nur relevant für Kontrollgruppen (siehe unten)
** <code>Kontrollgruppen: KGRP: Z</code> = Zusammenfassung verschiedener Kontrollfunktionen
** <code>Wert  1</code>: Kontrolliert IST - Wert
** <code>Wert  2</code>: Kontrolliert FAKTOR - Wert


<!--T:17-->
<!--T:17-->
* <code>'''L'''</code>: Ausgabe der Entladungswelle in einer KWL-Datei [J/N]
* <code>'''L'''</code>: Ausgabe der Ganglinie in einer KTR.WEL-Datei [J/N]
* <code>'''M'''</code>: <span style="color:red">???</span>
* <code>'''M'''</code>: <span style="color:red">???</span>
* <code>'''N'''</code>: <span style="color:red">???</span>
* <code>'''N'''</code>: '''Settings''', jeweils mit <code>J</code>/<code>N</code> einstellbar:
 
** <code>F</code>: <span style="color:red">???</span>
 
** <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>Zielwert</code>==== <!--T:18-->
** <code>T</code>: <span style="color:red">???</span>
 
* '''Sollwert''' (nur erforderlich, wenn Steuerungstyp B)
<!--T:19-->
** <code>'''O'''</code>: Sollwert [Tsd m³; m³, mm]
nur erforderlich, wenn Steuerungstyp B
** <code>'''P'''</code>: Jahresgang des Sollwerts
* <code>'''O'''</code>: Zielwert [Tsd m³; m³, mm]
* '''Istwert''' (nur erforderlich, wenn Steuerungstyp B und/oder C)
* <code>'''P'''</code>: Jährliches Muster des Zielwertes
** <code>'''Q'''</code>: ID des Berechnungstyps des Ist-Wertes/aktuellen wertes: [1-4]
 
 
 
====<code>Ist-Wert / aktueller Wert</code>==== <!--T:20-->
 
<!--T:21-->
nur erforderlich, wenn Steuerungstyp B und/oder C
 
<!--T:22-->
* <code>'''Q'''</code>: ID des Berechnungstyps des Ist-Wertes/aktuellen wertes: [1-4]
 
<!--T:23-->
: '''Berechnungstyp 1: variabel, gleitender Zeithorizont'''
: '''Berechnungstyp 1: variabel, gleitender Zeithorizont'''
* <code>'''R'''</code>: ID des Berechnungstyps des Ist-Wertes/aktuellen Wertes: [1-3]
* <code>'''R'''</code>: ID des Berechnungstyps des Ist-Wertes/aktuellen Wertes: [1-3]
<!--T:24-->
: '''Berechnungstyp 2: fester Zeithorizont'''
: '''Berechnungstyp 2: fester Zeithorizont'''
* <code>'''S'''</code>: Beginn <code>[TT.MM] [Tag.Monat]</code>
* <code>'''S'''</code>: Beginn <code>[TT.MM] [Tag.Monat]</code>
* <code>'''T'''</code>: Ende <code>[TT.MM] [Tag.Monat]</code>
* <code>'''T'''</code>: Ende <code>[TT.MM] [Tag.Monat]</code>
<!--T:25-->
: '''Berechnungstyp 3: fester Zeithorizont Monat'''
: '''Berechnungstyp 3: fester Zeithorizont Monat'''
* <code>'''U'''</code>: Wert ist nicht erforderlich, wird nicht importiert
* <code>'''U'''</code>: Wert ist nicht erforderlich, wird nicht importiert
<!--T:26-->
: '''Berechnungstyp 4: <span style="color:red">???</span>'''
: '''Berechnungstyp 4: <span style="color:red">???</span>'''
* <code>'''W'''</code>: <span style="color:red">???</span>'''
* <code>'''W'''</code>: <span style="color:red">???</span>'''
 
* '''Min / Max Werte''': (nur für Kontrollgruppen)
 
** <code>'''X'''</code>: <span style="color:red">???</span>'''
 
** <code>'''Y'''</code>: <span style="color:red">???</span>'''
====<code>minimaler / maximaler Wert</code>==== <!--T:27-->
** <code>'''Z'''</code>: <span style="color:red">???</span>'''
 
* '''Koordinaten'''
<!--T:28-->
** <code>'''K1'''</code>: Kontrollgruppenfenster x-Wert
nur für Kontrollgruppen
** <code>'''K2'''</code>: Kontrollgruppenfenster y-Wert
* <code>'''X'''</code>: <span style="color:red">???</span>'''
* '''Achsenbeschriftung'''
* <code>'''Y'''</code>: <span style="color:red">???</span>'''
** <code>'''A1'''</code>: Beschriftung x-Achse
* <code>'''Z'''</code>: <span style="color:red">???</span>'''
** <code>'''A2'''</code>: Beschriftung y-Achse
 
* '''Werte Änderung'''
 
** <code>'''N1'''</code>: Kennung [0-3]
====<code>Koordinaten</code>==== <!--T:29-->
*** <code>0</code>: <span style="color:red">???</span>'''
 
*** <code>1</code>: <span style="color:red">???</span>'''
<!--T:30-->
*** <code>2</code>: <span style="color:red">???</span>'''
* <code>'''K1'''</code>: Kontrollgruppenfenster x-Wert
*** <code>3</code>: <span style="color:red">???</span>'''
* <code>'''K2'''</code>: Kontrollgruppenfenster y-Wert
* <code>'''T1'''</code>: Typ <span style="color:red">???</span>
 
* <code>'''F1'''</code>: Faktor <span style="color:red">???</span>
 
 
====<code>Achsenbeschriftung</code>==== <!--T:31-->
 
<!--T:32-->
* <code>'''A1'''</code>: Beschriftung x-Achse
* <code>'''A2'''</code>: Beschriftung y-Achse
 
 
 
====<code>Werte Änderung</code>==== <!--T:33-->
 
<!--T:34-->
* <code>'''N1'''</code>: Kennung [0-3]
** <code>0</code>: <span style="color:red">???</span>'''
** <code>1</code>: <span style="color:red">???</span>'''
** <code>2</code>: <span style="color:red">???</span>'''
** <code>3</code>: <span style="color:red">???</span>'''
 
<!--T:35-->
* <code>'''T1'''</code>: <span style="color:red">???</span>'''
* <code>'''F1'''</code>: <span style="color:red">???</span>'''
* <code>'''D1'''</code>: Bezugsdatum <code>[TT.MM.JJJ hh:mm]</code>
* <code>'''D1'''</code>: Bezugsdatum <code>[TT.MM.JJJ hh:mm]</code>
* <code>'''G1'''</code>: <span style="color:red">???</span>'''
* <code>'''G1'''</code>: <span style="color:red">???</span>'''
Zeile 187: Zeile 140:
* <code>'''G3'''</code>: <span style="color:red">???</span>'''
* <code>'''G3'''</code>: <span style="color:red">???</span>'''


 
===Kontroll-Gruppen=== <!--T:36-->
 
===<code>Kontroll-Gruppen</code>=== <!--T:36-->


<!--T:37-->
<!--T:37-->
wie Kontrollfunktionen, jedoch mit den folgenden Unterschieden:
wie Kontrollfunktionen, jedoch mit den folgenden Unterschieden:
* <code>'''A'''</code>: ID der Kontrollgruppe (muss KGRP sein!)
* <code>'''A'''</code>: ID der Kontrollgruppe (muss <code>KGRP</code> sein!)
* <code>'''H'''</code>: nicht relevant für Kontrollgruppen
* <code>'''H'''</code>: nicht relevant für Kontrollgruppen
* <code>'''I'''</code>: Berechnungsregeln für die Kombination von Kontrollfunktionen/Gruppen. Mögliche Operatoren sind: +, -, *, /, <, >, <=, >=
* <code>'''I'''</code>: Berechnungsregeln für die Kombination von Kontrollfunktionen/Gruppen. Mögliche Operatoren sind: +, -, *, /, <, >, <=, >=

Version vom 8. Februar 2021, 11:29 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 erforderlich, wenn Steuerungstyp B und/oder C)
    • Q: ID des Berechnungstyps des Ist-Wertes/aktuellen wertes: [1-4]
Berechnungstyp 1: variabel, gleitender Zeithorizont
  • R: ID des Berechnungstyps des Ist-Wertes/aktuellen Wertes: [1-3]
Berechnungstyp 2: fester Zeithorizont
  • S: Beginn [TT.MM] [Tag.Monat]
  • T: Ende [TT.MM] [Tag.Monat]
Berechnungstyp 3: fester Zeithorizont Monat
  • U: Wert ist nicht erforderlich, wird nicht importiert
Berechnungstyp 4: ???
  • W: ???
  • Min / Max Werte: (nur für Kontrollgruppen)
    • X: ???
    • Y: ???
    • Z: ???
  • Koordinaten
    • K1: Kontrollgruppenfenster x-Wert
    • K2: Kontrollgruppenfenster y-Wert
  • Achsenbeschriftung
    • A1: Beschriftung x-Achse
    • A2: Beschriftung y-Achse
  • Werte Änderung
    • N1: Kennung [0-3]
      • 0: ???
      • 1: ???
      • 2: ???
      • 3: ???
  • T1: Typ ???
  • F1: Faktor ???
  • D1: Bezugsdatum [TT.MM.JJJ hh:mm]
  • G1: ???
  • G2: ???
  • G3: ???

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
Abgerufen von „https://www.talsim.de/docs/index.php?title=KTR-Datei&oldid=11202“