KTR-File: Difference between revisions

From BlueM
Jump to navigation Jump to search
m (moved KTR-Datei to KTR-File)
(nicht genutzte Spalten entfernt, Erläuterung überarbeitet, Originaldatei in Talk:KTR-File)
Line 1: Line 1:
__NOTOC__
{{Eingabedateien}}
{{Eingabedateien}}


Line 6: Line 7:


==Datei==
==Datei==
Mit Beispiel für die Berechnung der Wasserkrafterzeugung an einer Talsperre.
<bluem>
<bluem>
*Kontrollfunktionen (*.KTR)
*Kontrollfunktionen (*.KTR)
*==========================
*==========================
*
*
**Kontrolltypen:  Typ: A = Aktuelle Systemzustaende
*Kontrolltypen:  Typ: A = Aktuelle Systemzustaende
*                    B = Bilanzen (Abweichungen vom Sollwert)
*                    B = Bilanzen (Abweichungen vom Sollwert)
*                    C = Bilanzen (aktuelle Systemzustaende)
*                    C = Bilanzen (aktuelle Systemzustaende)
*                    P = Pegel
*                    P = Pegel
*
*
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-------------------------------------|-----------------------------------------------|------------------------------|--------------------------------------------|
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-------------------------------|
*| Bez.  |KTR| Funkt.|KTR| Sys-| 1.KTR    |WEL|    Beschreibung    | S O L L W E R T|            I S T W E R T           |            K O O R D I N A T E N              |      ACHSENBESCHRIFTUNG      |        W E R T E  A E N D E R U N G      |
*| Bez.  |KTR| Funkt.|KTR| Sys-| 1.KTR    |WEL|    Beschreibung    | S O L L W E R T|            I S T W E R T     |
*|      an|Kng| S Z A |Typ|zust.|Z Kng Fak |  |                      |    Wert    JGG | Kng |Zschr|fest.Zeitraum|Monat|XZsch|                                              |                              |Kng|Intervall    Bezugsdatum  | konst.Gang |
*|      an|Kng| S Z A |Typ|zust.|Z Kng Fak |  |                      |    Wert    JGG | Kng |Zschr|fest.Zeitraum|Monat|
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|--4--|-----------------------|-----------------------|------------------------------|---|-----------(1)-------------|----(2)-----|
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|
*|        |  |      |  |    |          |  |                      |  Tsd.m3      | 1-4 | max.| Start  Ende | dt= | max.| Systemzustandsfenster | Kontrollgruppenfenster|    X-Achse        Y-Achse    |0-3|Typ Faktor  Bezugsdatum  |JGG WGG TGG |
*|        |  |      |  |    |          |  |                      |  Tsd.m3      | 1-3 | max.| Start  Ende | dt= |
*|    J/N|  | J/N i |  |    |          |  |                      |  m3/s, mm  -  |    | 7200| tt.mm tt.mm |Monat| 7200|      x        y      |      x        y      |                              |  |                          |            |
*|    J/N|  | J/N i |  |    |          |  |                      |  m3/s, mm  -  |    | 7200| tt.mm tt.mm |Monat|
*|-<-->-+-|<->|-+-+-+-|-+-|-<->-|<><-><--->|-+-|-<------------------>-|-<-------->-<->-|-<->-|<--->|-++.++-++.++-|-----|<--->|-<-------->-<-------->-|-<-------->-<-------->-|<-------------><------------->|<->|<->-<---->-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  |  |    V          W     |    X         Y      |      Z            AA      | AB| AC  AD        AE        | AF  AG  AH |
*|  A  B | C | D E F | G |  H  | I J  K  | L |          M          |    N      O  |  P  |  Q  |  R    S  |  T  |
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|--4--|-----------------------|-----------------------|------------------------------|---|-----------(1)-------------|----(2)-----|
  | T100 J |y01| J N 0 | A | QA1 |          | J | Turbine discharge    |                |    |     |            |    |
| T100 J |y02| J N 3 | F | WSP |         | J | Hydraulic head       |               |    |    |             |     |
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|
*
*
*Kontrollgruppen: KGRP: Z = Zusammenfassung verschiedener Kontrollfunktionen
*Kontrollgruppen: KGRP: Z = Zusammenfassung verschiedener Kontrollfunktionen
Line 29: Line 33:
*                      2 : Kontrolliert FAKTOR - Wert
*                      2 : Kontrolliert FAKTOR - Wert
*
*
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-------------------------------------|-----------------------------------------------|------------------------------|--------------------------------------------|
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-------------------------------|
*| Bez.  |KTR| Funkt.|KTR| Sys-| 1.KTR    |WEL|    Beschreibung    | S O L L W E R T|            I S T W E R T           |            K O O R D I N A T E N              |      ACHSENBESCHRIFTUNG      |        W E R T E  A E N D E R U N G      |
*| Bez.  |KTR| Funkt.|KTR| Sys-| 1.KTR    |WEL|    Beschreibung    | S O L L W E R T|            I S T W E R T     |
*|      an|Kng| S Z A |Typ|zust.|Z Kng Fak |  |                      |    Wert    JGG | Kng |Zschr|fest.Zeitraum|Monat|XZsch|                                              |                              |Kng|Intervall    Bezugsdatum  | konst.Gang |
*|      an|Kng| S Z A |Typ|zust.|Z Kng Fak |  |                      |    Wert    JGG | Kng |Zschr|fest.Zeitraum|Monat|
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|--4--|-----------------------|-----------------------|------------------------------|---|-----------(1)-------------|----(2)-----|
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|
*|        |  |      |  |    |          |  |                      |  Tsd.m3      | 1-4 | max.| Start  Ende | dt= | max.| Systemzustandsfenster | Kontrollgruppenfenster|    X-Achse        Y-Achse    |0-3|Typ Faktor  Bezugsdatum  |JGG WGG TGG |
*|        |  |      |  |    |          |  |                      |  Tsd.m3      | 1-3 | max.| Start  Ende | dt= |
*|    J/N|  | J/N i |  |    |          |  |                      |  m3/s, mm  -  |    | 7200| tt.mm tt.mm |Monat| 7200|      x        y      |      x        y      |                              |  |                          |            |
*|    J/N|  | J/N i |  |    |          |  |                      |  m3/s, mm  -  |    | 7200| tt.mm tt.mm |Monat|
*|-<-->-+-|<->|-+-+-+-|-+-|-<->-|<><-><--->|-+-|-<------------------>-|-<-------->-<->-|-<->-|<--->|-++.++-++.++-|-----|<--->|-<-------->-<-------->-|-<-------->-<-------->-|<-------------><------------->|<->|<->-<---->-TT.MM.JJJJ hh:mm|<->-<->-<->-|
*|-<-->-+-|<->|-+-+-+-|-+-|-<->-|<><-><--->|-+-|-<------------------>-|-<-------->-<->-|-<->-|<--->|-++.++-++.++-|-----|
  |  A  A | B | C C C | D E |F F   F | G |                     |               |     |    |             |     |    |                       |                       |                             |   |                           |           |
*|   A  B | C | D E F | G | H | I J  K | L |         M          |     N      O  P Q  |  R    S   |  T  |
  | 1   2 | 1 | 1 2 3 | 1 | |1  2   3  | 1 |                      |                |    |    |            |    |    |                      |                      |                              |  |                          |            |
  | KGRP J |y03| J N 0 | A |    |+ y01 0.85| J | Hydropower production|               |     |     |             |     |
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|--4--|-----------------------|-----------------------|------------------------------|---|---------------------------|------------|
  |       |   |       |   |     |* y02 9.81|  |                      |                |    |    |            |    |
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|
</bluem>
</bluem>


Line 47: Line 52:
===Kontrollfunktionen===
===Kontrollfunktionen===
'''Allgemein'''
'''Allgemein'''
*A: Kennung des Elements, von dem ein Systemzustand abgegriffen werden soll
*'''A''': Kennung des Elements, von dem ein Systemzustand abgegriffen werden soll
*B: Kontrollfunktion aktiv? [J/N]
*'''B''': Kontrollfunktion aktiv? [J/N]
*C: eindeutige Kennung der Kontrollfunktion ''(muss mit '''y''' anfangen!)''
*'''C''': eindeutige Kennung der Kontrollfunktion (muss mit <code>y</code> anfangen!)
*D: Interpolation zwischen Stützstellen [J/N]  
*'''D''': Interpolation zwischen Stützstellen [J/N]  
*E: Interpolation in der Zeit [J/N]
*'''E''': Interpolation in der Zeit [J/N]
*F: [[Funktionsarten|Funktionsart]] ''(muss mit der angegebenen Funktionsart in der [[FKT-Datei]] übereinstimmen!)''
*'''F''': [[Funktionsarten|Funktionsart]] ''(muss mit der angegebenen Funktionsart in der [[FKT-Datei]] übereinstimmen!)''
*G: Kontrolltyp: A = aktueller Zustand; F = Funktion; B = Bilanz mit Soll; C = Bilanz ohne Soll; P = Kontrollpegel
*'''G''': Kontrolltyp:  
*H: Systemzustand (je nach Elementtyp andere Möglichkeiten, z.B. 1AB, 1ZU. Bei Talsperren auch VOL, WSP, oder Kennung der Steuerfunktion)
** <code>A</code> = aktueller Zustand
*I, J, K: nur für Kontrollgruppen relevant
** <code>F</code> = Funktion
*L: Wellenausgabe in [[KWL-Datei]] [J/N]
** <code>B</code> = Bilanz mit Soll
*M: Beschreibung
** <code>C</code> = Bilanz ohne Soll
'''Sollwert ''(nur bei Kontrolltyp B)'''''
** <code>P</code> = Kontrollpegel
*N: [Tsd m³; m³, mm]
*'''H''': Systemzustand (je nach Elementtyp verschiedene Möglichkeiten, z.B. <code>1AB</code>, <code>1ZU</code>. Bei Talsperren auch <code>VOL</code>, <code>WSP</code>, oder Kennung der Steuerfunktion)
*O: Sollwert: Jahresganglinie
*'''I, J, K''': nur für [[#Kontrollgruppen|Kontrollgruppen]] relevant
'''Ist-Wert ''(nur bei Kontrolltypen B und C)'''''
*'''L''': Wellenausgabe in [[KWL-Datei]] [J/N]
*P: Kennung für die Berechnungsart des Ist-Werts: [1-4]
*'''M''': Beschreibung
'''Sollwert''' (nur bei Kontrolltyp <code>B</code>)
*'''N''': Sollwert [Tsd m³; m³, mm]
*'''O''': [[JGG-Datei|Jahresgang]] für Sollwert
'''Ist-Wert''' (nur bei Kontrolltypen <code>B</code> und <code>C</code>)
*'''P''': Kennung für die Berechnungsart des Ist-Werts: [1-3]
:'''Berechnungsart 1: variabler, gleitender Zeithorizont'''
:'''Berechnungsart 1: variabler, gleitender Zeithorizont'''
:*Q: Anzahl Zeitschritte [max. 7200]
:*'''Q''': Anzahl Zeitschritte [max. 7200]
:'''Berechnungsart 2: fixer Zeithorizont'''
:'''Berechnungsart 2: fixer Zeithorizont'''
:*R: Startdatum [TT.MM]
:*'''R''': Startdatum [TT.MM]
:*S: Enddatum [TT.MM]
:*'''S''': Enddatum [TT.MM]
:'''Berechnungsart 3: fixer Zeithorizont Monat'''
:'''Berechnungsart 3: fixer Zeithorizont Monat'''
:*T: (Ist-Wert: Monat?)
:*'''T''': ''Wert nicht notwendig, wird nicht eingelesen''
:'''Berechnungsart 4: ???''' ''(nicht implementiert, siehe Bug 340!)''
:*U: Ist-Wert: Zeitschritt [max. 7200]
'''Koordinaten'''
*V, W, X, Y: Nur für graphische Oberfläche von Bedeutung
'''Achsenbeschriftung'''
*Z, AA: Nur für graphische Oberfläche von Bedeutung
'''Werteänderung'''
*AB: Kennung
*AC: Typ
*AD: Faktor
*AE: Tagesganglinien
*AF: Wochenganglinien
*AG: Jahresganglinien


===Kontrollgruppen===
===Kontrollgruppen===
 
Siehe [[#Kontrollfunktionen|Kontrollfunktionen]], aber mit folgenden Unterschieden:
'''Allgemein'''
*'''A''': Kennung der Kontrollgruppe (muss gleich <code>KGRP</code> sein!)
*A1: Kennung des Elements, bei kontrollgruppen ist 'KGRP' obligatorisch
*'''H''': Für Kontrollgruppen irrelevant
*A2: Kontrollfunktion aktiv? [J/N]
*'''I''': Rechenvorschrift zur Kombination von Kontrollfunktionen / -gruppen. Mögliche Operatoren sind: +, -, *, /, <, >, <=, >=
*B1: eindeutige Kennung der Kontrollfunktion ''(muss mit '''y''' anfangen!)''
*'''J''': Kennung der Kontrollfunktion, die verarbeitet werden soll (siehe '''C''')
*C1: Interpolation zwischen Stützstellen [J/N]
*'''K''': Multiplikator für diese Kontrollfunktion
*C2: Interpolation in der Zeit [J/N]
*C3: [[Funktionsarten|Funktionsart]]
*D1: Kontrolltyp: A = aktueller Zustand; F = Funktion; B = Bilanz mit Soll; C = Bilanz ohne Soll; P = Kontrollpegel
*E1: dieser Paramter ist für Kontrollgruppen nicht relevant und wird daher nicht eingelesen
*F1: Rechenvorschrift zur Kombination von Kontrollfunktionen / -gruppen. Mögliche Operatoren sind: +, -, *, /, <, >, <=, >=  
*F2: Kennung der Kontrollfunktion, die verarbeitet werden soll
*F3: Multiplikator für diese Kontrollfunktion
*G1: Wellenausgabe in der [[KWL-Datei]] [J/N]


[[Kategorie:BlueM Eingabedateien]]
[[Kategorie:BlueM Eingabedateien]]

Revision as of 01:42, 9 October 2009

BlueM_icon.png BlueM.Sim | Download | Application | Theory | Development

Input files · ALL SYS · FKT KTR · EXT JGG WGG TGG · TAL HYA TRS EIN URB VER RUE BEK EZG FKA · BOA BOD LNZ EFL · DIF


Kontrollfunktionen

siehe auch Theorie:Systemzustände

Datei

Mit Beispiel für die Berechnung der Wasserkrafterzeugung an einer Talsperre.

*Kontrollfunktionen (*.KTR)
*==========================
*
*Kontrolltypen:  Typ: A = Aktuelle Systemzustaende
*                     B = Bilanzen (Abweichungen vom Sollwert)
*                     C = Bilanzen (aktuelle Systemzustaende)
*                     P = Pegel
*
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-------------------------------|
*| Bez.   |KTR| Funkt.|KTR| Sys-| 1.KTR    |WEL|     Beschreibung     | S O L L W E R T|             I S T W E R T     |
*|      an|Kng| S Z A |Typ|zust.|Z Kng Fak |   |                      |    Wert    JGG | Kng |Zschr|fest.Zeitraum|Monat|
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|
*|        |   |       |   |     |          |   |                      |   Tsd.m3       | 1-3 | max.| Start  Ende | dt= |
*|     J/N|   | J/N i |   |     |          |   |                      |  m3/s, mm   -  |     | 7200| tt.mm tt.mm |Monat|
*|-<-->-+-|<->|-+-+-+-|-+-|-<->-|<><-><--->|-+-|-<------------------>-|-<-------->-<->-|-<->-|<--->|-++.++-++.++-|-----|
*|   A  B | C | D E F | G |  H  | I J   K  | L |          M           |     N       O  |  P  |  Q  |   R     S   |  T  |
 | T100 J |y01| J N 0 | A | QA1 |          | J | Turbine discharge    |                |     |     |             |     |
 | T100 J |y02| J N 3 | F | WSP |          | J | Hydraulic head       |                |     |     |             |     |
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|
*
*Kontrollgruppen: KGRP: Z = Zusammenfassung verschiedener Kontrollfunktionen
*                 Wert: 1 : Kontrolliert IST  - Wert
*                       2 : Kontrolliert FAKTOR - Wert
*
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-------------------------------|
*| Bez.   |KTR| Funkt.|KTR| Sys-| 1.KTR    |WEL|     Beschreibung     | S O L L W E R T|             I S T W E R T     |
*|      an|Kng| S Z A |Typ|zust.|Z Kng Fak |   |                      |    Wert    JGG | Kng |Zschr|fest.Zeitraum|Monat|
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|
*|        |   |       |   |     |          |   |                      |   Tsd.m3       | 1-3 | max.| Start  Ende | dt= |
*|     J/N|   | J/N i |   |     |          |   |                      |  m3/s, mm   -  |     | 7200| tt.mm tt.mm |Monat|
*|-<-->-+-|<->|-+-+-+-|-+-|-<->-|<><-><--->|-+-|-<------------------>-|-<-------->-<->-|-<->-|<--->|-++.++-++.++-|-----|
*|   A  B | C | D E F | G |  H  | I J   K  | L |          M           |     N       O  |  P  |  Q  |   R     S   |  T  |
 | KGRP J |y03| J N 0 | A |     |+ y01 0.85| J | Hydropower production|                |     |     |             |     |
 |        |   |       |   |     |* y02 9.81|   |                      |                |     |     |             |     |
*|--------|---|-------|---|-----|----------|---|----------------------|----------------|-----|--1--|------2------|--3--|

Erläuterungen

Hinweis
Kontrollfunktionen, die auf das gleiche Systemelement zeigen, müssen unmittelbar untereinander stehen (Bug 342)

Kontrollfunktionen

Allgemein

  • A: Kennung des Elements, von dem ein Systemzustand abgegriffen werden soll
  • B: Kontrollfunktion aktiv? [J/N]
  • C: eindeutige Kennung der Kontrollfunktion (muss mit y anfangen!)
  • D: Interpolation zwischen Stützstellen [J/N]
  • E: Interpolation in der Zeit [J/N]
  • F: Funktionsart (muss mit der angegebenen Funktionsart in der FKT-Datei übereinstimmen!)
  • G: Kontrolltyp:
    • A = aktueller Zustand
    • F = Funktion
    • B = Bilanz mit Soll
    • C = Bilanz ohne Soll
    • P = Kontrollpegel
  • H: Systemzustand (je nach Elementtyp verschiedene Möglichkeiten, z.B. 1AB, 1ZU. Bei Talsperren auch VOL, WSP, oder Kennung der Steuerfunktion)
  • I, J, K: nur für Kontrollgruppen relevant
  • L: Wellenausgabe in KWL-Datei [J/N]
  • M: Beschreibung

Sollwert (nur bei Kontrolltyp B)

  • N: Sollwert [Tsd m³; m³, mm]
  • O: Jahresgang für Sollwert

Ist-Wert (nur bei Kontrolltypen B und C)

  • P: Kennung für die Berechnungsart des Ist-Werts: [1-3]
Berechnungsart 1: variabler, gleitender Zeithorizont
  • Q: Anzahl Zeitschritte [max. 7200]
Berechnungsart 2: fixer Zeithorizont
  • R: Startdatum [TT.MM]
  • S: Enddatum [TT.MM]
Berechnungsart 3: fixer Zeithorizont Monat
  • T: Wert nicht notwendig, wird nicht eingelesen

Kontrollgruppen

Siehe Kontrollfunktionen, aber mit folgenden Unterschieden:

  • A: Kennung der Kontrollgruppe (muss gleich KGRP sein!)
  • H: Für Kontrollgruppen irrelevant
  • I: Rechenvorschrift zur Kombination von Kontrollfunktionen / -gruppen. Mögliche Operatoren sind: +, -, *, /, <, >, <=, >=
  • J: Kennung der Kontrollfunktion, die verarbeitet werden soll (siehe C)
  • K: Multiplikator für diese Kontrollfunktion