KTR-File: Difference between revisions

From BlueM
Jump to navigation Jump to search
(Übersetzung)
Line 2: Line 2:
{{Eingabedateien}}
{{Eingabedateien}}


<big>Kontrollfunktionen</big>
<big>Control functions</big>


''siehe auch [[Systemzustände|Theorie:Systemzustände]]''
''also refer to [[Systemzustände|Theorie:Systemzustände]]''


==Datei==
==File==
Mit Beispiel für die Berechnung der Wasserkrafterzeugung an einer Talsperre.
Including an example for the calculation of hydropower production at a dam.
<bluem>
<bluem>
*Kontrollfunktionen (*.KTR)
*Kontrollfunktionen (*.KTR)
Line 46: Line 46:
</bluem>
</bluem>


==Erläuterungen==
==Explanations==


;Hinweis:Kontrollfunktionen, die auf das gleiche Systemelement zeigen, müssen unmittelbar untereinander stehen (Bug 342)
;Hint:Control functions for the same element must be listed immediately one after anathoer (Bug 342)


===Kontrollfunktionen===
===Control functions===
'''Allgemein'''
'''General'''
*'''A''': Kennung des Elements, von dem ein Systemzustand abgegriffen werden soll
*'''A''': Identification of the element from which a system status is to be called
*'''B''': Kontrollfunktion aktiv? [J/N]
*'''B''': Control funcion enabled/disabled? [J/N] J = Yes, N = No
*'''C''': eindeutige Kennung der Kontrollfunktion (muss mit <code>y</code> anfangen!)
*'''C''': Distinctive identifier of the control function(must begin with <code>y</code>!)
*'''D''': Interpolation zwischen Stützstellen [J/N]  
*'''D''': Interpolation between supporting points [J/N]  
*'''E''': Interpolation in der Zeit [J/N]
*'''E''': Interpolation in time [J/N]
*'''F''': [[Funktionsarten|Funktionsart]] (bei Kontrolltyp <code>F</code> muss diese mit der angegebenen Funktionsart in der [[FKT-Datei]] übereinstimmen, bei anderen Kontrolltypen sollte sie 0 sein!)
*'''F''': [[Funktionsarten|Funktionsart]] (if control-type <code>F</code> it must be identical to the function-type in the [[FKT-Datei]]. For other control-types it should always be 0!
*'''G''': Kontrolltyp:  
*'''G''': Control-type:  
** <code>A</code> = aktueller Zustand
** <code>A</code> = current status
** <code>F</code> = Funktion (in diesem Fall muss die entsprechende Funktion in der [[FKT-Datei]] definiert sein!)
** <code>F</code> = Function (in this case the function must be defined in the [[FKT-Datei]]!)
** <code>B</code> = Bilanz mit Soll
** <code>B</code> = Balance with target/reference
** <code>C</code> = Bilanz ohne Soll
** <code>C</code> = Balance without target/reference
** <code>P</code> = Kontrollpegel
** <code>P</code> = Control water gage
*'''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)
*'''H''': System status ( different possibilities according to element-type, e.g. <code>1AB</code>, <code>1ZU</code>. For a dam  also <code>VOL</code>, <code>WSP</code> or the identification of the control/steering function)
*'''I, J, K''': nur für [[#Kontrollgruppen|Kontrollgruppen]] relevant
*'''I, J, K''': only relevent for [[#Kontrollgruppen|Kontrollgruppen]]  
*'''L''': Wellenausgabe in [[KWL-Datei]] [J/N]
*'''L''': Discharge wave output in a [[KWL-Datei]] [J/N]
*'''M''': Beschreibung
*'''M''': Description
'''Sollwert''' (nur bei Kontrolltyp <code>B</code>)
'''Target-value''' (required only if control-type <code>B</code>)
*'''N''': Sollwert [Tsd m³; m³, mm]
*'''N''': Target-value [Tsd m³; m³, mm]
*'''O''': [[JGG-Datei|Jahresgang]] für Sollwert
*'''O''': [[JGG-Datei|Jahresgang]] of the target-value
'''Ist-Wert''' (nur bei Kontrolltypen <code>B</code> und <code>C</code>)
'''Is-value / current value''' (required only if control-type <code>B</code> and/or <code>C</code>)
*'''P''': Kennung für die Berechnungsart des Ist-Werts: [1-3]
*'''P''': Identifier of the calculation-type of the is-value /current value: [1-3]
:'''Berechnungsart 1: variabler, gleitender Zeithorizont'''
:'''Calculation-type 1: variable, gliding time horizon
:*'''Q''': Anzahl Zeitschritte [max. 7200]
:*'''Q''': Number of time inrements [max. 7200]
:'''Berechnungsart 2: fixer Zeithorizont'''
:'''Calculation-type 2: fix time horizon'''
:*'''R''': Startdatum [TT.MM]
:*'''R''': Beginning [TT.MM] [day.month]
:*'''S''': Enddatum [TT.MM]
:*'''S''': End [TT.MM] [day.month]
:'''Berechnungsart 3: fixer Zeithorizont Monat'''
:'''Calculation-type 3: fix time horizon month'''
:*'''T''': ''Wert nicht notwendig, wird nicht eingelesen''
:*'''T''': '' Value is not required, is not imported''
 
===Control-groups===
Refer to [[#Kontrollfunktionen|Kontrollfunktionen]],however with the following differences:
*'''A''': Identifier of the control-group(has to be <code>KGRP</code>!)
*'''H''': Irrelevant for control-groups
*'''I''': Calculation rules for the combination of control-functions/groups. Possible operator are: +, -, *, /, <, >, <=, >=
*'''J''': Identifier of the control-function which is to be utilized (refer to '''C''')
*'''K''': Multiplier for ths control-function


===Kontrollgruppen===
Siehe [[#Kontrollfunktionen|Kontrollfunktionen]], aber mit folgenden Unterschieden:
*'''A''': Kennung der Kontrollgruppe (muss gleich <code>KGRP</code> 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


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

Revision as of 04:51, 21 December 2012

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

Control functions

also refer to Theorie:Systemzustände

File

Including an example for the calculation of hydropower production at a dam. 

*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--|

Explanations

Hint
Control functions for the same element must be listed immediately one after anathoer (Bug 342)

Control functions

General

  • A: Identification of the element from which a system status is to be called
  • B: Control funcion enabled/disabled? [J/N] J = Yes, N = No
  • C: Distinctive identifier of the control function(must begin with y!)
  • D: Interpolation between supporting points [J/N]
  • E: Interpolation in time [J/N]
  • F: Funktionsart (if control-type F it must be identical to the function-type in the FKT-Datei. For other control-types it should always be 0!
  • G: Control-type:
    • A = current status
    • F = Function (in this case the function must be defined in the FKT-Datei!)
    • B = Balance with target/reference
    • C = Balance without target/reference
    • P = Control water gage
  • H: System status ( different possibilities according to element-type, e.g. 1AB, 1ZU. For a dam also VOL, WSP or the identification of the control/steering function)
  • I, J, K: only relevent for Kontrollgruppen
  • L: Discharge wave output in a KWL-Datei [J/N]
  • M: Description

Target-value (required only if control-type B)

  • N: Target-value [Tsd m³; m³, mm]
  • O: Jahresgang of the target-value

Is-value / current value (required only if control-type B and/or C)

  • P: Identifier of the calculation-type of the is-value /current value: [1-3]
Calculation-type 1: variable, gliding time horizon
  • Q: Number of time inrements [max. 7200]
Calculation-type 2: fix time horizon
  • R: Beginning [TT.MM] [day.month]
  • S: End [TT.MM] [day.month]
Calculation-type 3: fix time horizon month
  • T: Value is not required, is not imported

Control-groups

Refer to Kontrollfunktionen,however with the following differences:

  • A: Identifier of the control-group(has to be KGRP!)
  • H: Irrelevant for control-groups
  • I: Calculation rules for the combination of control-functions/groups. Possible operator are: +, -, *, /, <, >, <=, >=
  • J: Identifier of the control-function which is to be utilized (refer to C)
  • K: Multiplier for ths control-function
Retrieved from "https://wiki.bluemodel.org/index.php?title=KTR-File&oldid=6861"