TAL-File: Difference between revisions

From BlueM
Jump to navigation Jump to search
(Überarbeitung Übersetzung)
 
(8 intermediate revisions by 2 users not shown)
Line 5: Line 5:
<big>Dams</big>
<big>Dams</big>


''also refer to [[Speicher|Theorie:Speicher]] and[[Betriebsregelkonzept|Theorie:Betriebsregelkonzept]]''
''also refer to [[Speicher|Theory: Reservoirs]] and[[Betriebsregelkonzept|Theorie:Betriebsregelkonzept]]''


The TAL-File is split into sections.<br clear="all"/>
The TAL-File is split into sections.<br clear="all"/>
Line 31: Line 31:
Anfangsvolumen = initial volume <br />
Anfangsvolumen = initial volume <br />
Maximalvolumen = maximum volume <br />
Maximalvolumen = maximum volume <br />
Sohle = sohlheight <br />
Sohle = (reservoir)bed height <br />
HW-Entlastung = spillway <br />
HW-Entlastung = spillway <br />
Kante = ledge <br />
Kante = crest height <br />
S-Vol = reservoir volume <br />
S-Vol = reservoir volume <br />
Krone = crest <br />
Krone = crest <br />
Line 52: Line 52:
*A: ID of the dam (same as in the first segment)
*A: ID of the dam (same as in the first segment)
*B: Description of the dam (optional)
*B: Description of the dam (optional)
*C: Number of reservoir surface area functions(muss mit entsprechendem Abschnitt übereinstimmen)
*C: Number of reservoir surface area functions (has to correspond to the number of functions defined in the relevant section below)
*D: Number of dam-reservoir regulation functions(muss mit entsprechendem Abschnitt übereinstimmen)
*D: Number of dam-reservoir regulation functions (has to correspond to the number of functions defined in the relevant section below)
*E: Number of limit(ing) functions(muss mit entsprechendem Abschnitt übereinstimmen)
*E: Number of limit functions (has to correspond to the number of functions defined in the relevant section below)
*F: Number of internal dependencies
*F: Number of internal dependencies


Line 78: Line 78:
</bluem>
</bluem>
;Attention!
;Attention!
:There can only be a maximum of 40 supporting points(refer to Bug 32). If more supporting points are entered, an error will occur. Fehler 2231:
:There can only be a maximum of 40 supporting points (see [https://github.com/bluemodel/BlueM.Sim/issues/32 #32]). If more supporting points are entered, an error will occur. Fehler 2231:
<pre style="margin-left:25px;">
<pre style="margin-left:25px;">
  2231 Beim Systemelement .....................  XXXX
  2231 Beim Systemelement .....................  XXXX
Line 90: Line 90:
Oberfläche = surface area
Oberfläche = surface area


 
==Limit functions==
==limit(ing) functions==
<bluem>
<bluem>
2|      |------------------------- GRENZFUNKTIONEN -------------------------|------|-----|------------|------------------------------|--------------------------------------------|
2|      |------------------------- GRENZFUNKTIONEN -------------------------|------|-----|------------|------------------------------|--------------------------------------------|
Line 101: Line 100:
*|      |--------------------|---------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------|
*|      |--------------------|---------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------|
</bluem>
</bluem>
*A: Description of the limit(ing)function
*A: Description of the limit function
*B: ongoing number (starts with 1)
*B: ongoing number (starts with 1)
*C: Unique ID of function
*C: Unique ID of function
Line 108: Line 107:
*F, G, H: nur für graphische Oberfläche
*F, G, H: nur für graphische Oberfläche


The function itself is defined in the  [[FKT-Datei]] under its unique ID.
The function itself is defined in the  [[FKT-Datei|FKT-File]] under its unique ID.


''(Bei mir wurde der Wert für den minimalen Abfluss nicht ordnungsgemäß aus TALSIM exportiert! [[Benutzer:Froehlich|Froehlich]] 11:50, 9. Aug 2006 (CEST))''
''(Bei mir wurde der Wert für den minimalen Abfluss nicht ordnungsgemäß aus TALSIM exportiert! [[Benutzer:Froehlich|Froehlich]] 11:50, 9. Aug 2006 (CEST))''
Line 126: Line 125:
*B: Unique ID of the function
*B: Unique ID of the function
*C: Calculation type: [1 | 2]
*C: Calculation type: [1 | 2]
'''Calculation type 1: mean discharge with optional [[TSIM.JGG | Jahres]]/[[TSIM.WGG | Wochen]]/[[TSIM.TGG | Tagesgang]]''':
'''Calculation type 1: mean discharge with optional [[TSIM.JGG | annual]]/[[TSIM.WGG | weekly]]/[[TSIM.TGG | daily pattern]]''':
*D, E, F: Number of the [[TSIM.JGG | Jahres]]/[[TSIM.WGG | Wochen]]/[[TSIM.TGG | Tagesgangs]]to be used
*D, E, F: Number of the [[TSIM.JGG | annual]]/[[TSIM.WGG | weekly]]/[[TSIM.TGG | daily pattern]]to be used
*G: Mean value of the function [mm/d is converted internaly to m³/s.ha]
*G: Mean value of the function [mm/d is converted internaly to m³/s.ha]
'''Calculation type 2: time series out of a file'''
'''Calculation type 2: time series out of a file'''
Line 143: Line 142:
</bluem>
</bluem>


The function itself is defined in the  [[FKT-Datei]] under its distinctive identifier.
The function itself is defined in the  [[FKT-Datei|FKT-File]] under its distinctive identifier.
*A: Name/Description of the dam-reservoir regulation function
*A: Name/Description of the dam-reservoir regulation function
*B: ID the downstream receptacle, which receives the discharge(must be defined as downstream receptacle in the[[SYS-Datei]]!)
*B: ID the downstream receptacle, which receives the discharge(must be defined as downstream receptacle in the[[SYS-Datei|SYS-File]]!)
*C: (optional) ID of the conrtol function, with which the function shall be scaled (multiplied) (refer to [[KTR-Datei]])
*C: (optional) ID of the control function, with which the function shall be scaled (multiplied) (refer to [[KTR-Datei|-File]])
*D: unique ID of the function  
*D: unique ID of the function  
*E: Interpolation between supporting points? (Y/N)
*E: Interpolation between supporting points? (J/N)
*F: Interpolation in time? (Y/N)
*F: Interpolation in time? (J/N)
*G: [[Funktionsarten|Funktionsart]]
*G: [[Funktionsarten|function-type]]
*H: (optional) Number of the limit(ing) function(refer to [[#Grenzfunktionen | Grenzfunktionen]]), which is assigned to this dam-reservoir regulation function.
*H: (optional) Number of the limit(ing) function(refer to [[#Grenzfunktionen | limit functions]]), which is assigned to this dam-reservoir regulation function.
*I: dam-reservoir regulation function active(Y/N) (if no, the discharge of this function will be set to 0)
*I: dam-reservoir regulation function active(J/N) (if no, the discharge of this function will be set to 0)
*J: Calculation type  (Scaletype):
*J: Calculation type  (Scaletype):
'''Calculatin type 0: direct discharge''' ''(does not work, siehe Bug 15)''
'''Calculation type 0: direct discharge''' ''(does not work, refer to Bug 15)''


'''Calculation type 1: mean discharge with optional [[TSIM.JGG | Jahres]]/[[TSIM.WGG | Wochen]]/[[TSIM.TGG | Tagesgang]]''':
'''Calculation type 1: mean discharge with optional [[TSIM.JGG | annual]]/[[TSIM.WGG | weekly]]/[[TSIM.TGG | daily pattern]]''':
*L, M, N: Number of the utilized [[TSIM.JGG | Jahres]]/[[TSIM.WGG | Wochen]]/[[TSIM.TGG | Tagesgangs]]
*L, M, N: Number of the utilized [[TSIM.JGG | annual]]/[[TSIM.WGG | weekly]]/[[TSIM.TGG | daily pattern]]
*O: Mean discharge value  
*O: Mean discharge value  
'''Calculation type 2: time series:'''
'''Calculation type 2: time series:'''
*P: Number of the utilized time series (defined in [[EXT-Datei]])
*P: Number of the utilized time series (defined in [[EXT-Datei|EXT-File]])
'''Calculation type 3, 4 and 5: Hydraulics: overflow (3), pipe (4) and turbine (5):'''<br/>
'''Calculation type 3, 4 and 5: Hydraulics: overflow (3), pipe (4) and turbine (5):'''<br/>
*K: ID of the hydraulic element (refer to the[[HYA-Datei]], the calculation type chosen there must be identical with the chosen type here!)
*K: ID of the hydraulic element (refer to the[[HYA-Datei|HYA-File]], the calculation type chosen there must be identical with the chosen type here!)


*Q, R, S: nur für graphische Oberfläche
*Q, R, S: for graphical surfaces
*T, U, V, W, X, Y, Z: Werteänderung (?) ''(funzt nicht, siehe Bug 5)''
*T, U, V, W, X, Y, Z: Value alteration (?) ''(does not work, refer to Bug 5)''


==Internal dependencies==
==Internal dependencies==
Line 180: Line 179:
*A: Function ID
*A: Function ID
*B: Discharge, which must be surpassed in order for a reduction to occur
*B: Discharge, which must be surpassed in order for a reduction to occur
*C, D, E: Number of the utilized [[TSIM.JGG | Jahres]]/[[TSIM.WGG | Wochen]]/[[TSIM.TGG | Tagesgangs]] to scale QM  
*C, D, E: Number of the utilized [[TSIM.JGG | annual]]/[[TSIM.WGG | weekly]]/[[TSIM.TGG | daily pattern]] to scale QM  
'''F - H: Second condition:'''
'''F - H: Second condition:'''
*F: reservoir volume,whicht must be undershot in order for a reduction to occur  
*F: reservoir volume,which must be undershot in order for a reduction to occur  
*G, H: Number of the utilized [[TSIM.JGG | Jahres]]/[[TSIM.WGG | Wochengangs]] to scale the reservoir volume  
*G, H: Number of the utilized [[TSIM.JGG | annual]]/[[TSIM.WGG | weekly pattern]] to scale the reservoir volume  
'''I bis L: function ID and order of the dam-reservoir regulation functions, which are to be reduced'''
'''I - L: function ID and order of the dam-reservoir regulation functions, which are to be reduced'''


===Example===
===Example===
Line 195: Line 194:
  |      | QH1 |>=    0            |<=    30641        | QM1 QM2 QM3    |      |    |            |                              |                                            |
  |      | QH1 |>=    0            |<=    30641        | QM1 QM2 QM3    |      |    |            |                              |                                            |
</bluem>
</bluem>
;Meaning:If the Discharge from QH1 is greater or equal to 0 and the reservoir volume is less or equal to 30641 Tsd. m³, then reduce QM1 and if this is not sufficient, reduce QM2 and then QM3 until a reduction near the value of QH1 has been achieved.
;Meaning:If the Discharge from QH1 is greater or equal to 0 and the reservoir volume is less or equal to 30641 thsd. m³, then reduce QM1 and if this is not sufficient, also reduce QM2 and then QM3 until a total reduction amounting to the value of QH1 has been achieved.
[[Kategorie:BlueM Eingabedateien]]
 
[[Category:BlueM.Sim input files]]

Latest revision as of 05:01, 26 January 2024

BlueM_icon.png BlueM.Sim | Downloads | 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


Dams

also refer to Theory: Reservoirs andTheorie:Betriebsregelkonzept

The TAL-File is split into sections.

General Information

*Talsperren (*.TAL)
*==================
*
*|------|------------|------------|-----|----------|-----------------------|-----------------------|
*| Bez  |  Anfangs-  |  Maximal   | Ge- |  Sohle   |      HW-Entlastung    |      Krone            |
*|      |  volumen   |  volumen   |wicht|          |   Kante       S-Vol   |   Kante       S-Vol   |
*|------|------------|------------|-----|----------|-----------------------|-----------------------|
*|      | [Tsd.cbm]  | [Tsd.cbm]  |  -  |   [mNN]  |   [mNN]  | [Tsd.cbm]  |   [mNN]  | [Tsd.cbm]  |
*|-<-->-|-<-------->-|-<-------->-|-<->-|-<------>-|-<------>-|-<-------->-|-<------>-|-<-------->-|
 | T100 |      25060 |      30641 |  1  |      208 |    251.8 |      25060 |      255 |      30641 |
*|------|------------|------------|-----|----------|-----------------------|-----------------------|

This segment is self-explanatory. If there is more than one dam this line must be repeated for each dam.
The Identification of a dam must begin with a T.

Translations

Bez = ID of the Dam
Anfangsvolumen = initial volume
Maximalvolumen = maximum volume
Sohle = (reservoir)bed height
HW-Entlastung = spillway
Kante = crest height
S-Vol = reservoir volume
Krone = crest

Number of functions

0Funktionen für T100
*===================
*
*|------|------------------------------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------|
*| Bez.-|       Beschreibung           | F u n k t i o n e n                |      |     |            |                              |                                            |
*|------|                              | Anz. Anz. Anz. Anz.                |      |     |            |                              |                                            |
*|   -  |                              | Spe  Str  Grz  Abh                 |      |     |            |                              |                                            |
*|-<-->-|-<-------------------------->-|-<->--<->--<->--<->-----------------|------|-----|------------|------------------------------|--------------------------------------------|
 |   A  |             B                |  C    D    E    F                  |      |     |            |
*|      |------------------------------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------|
  • A: ID of the dam (same as in the first segment)
  • B: Description of the dam (optional)
  • C: Number of reservoir surface area functions (has to correspond to the number of functions defined in the relevant section below)
  • D: Number of dam-reservoir regulation functions (has to correspond to the number of functions defined in the relevant section below)
  • E: Number of limit functions (has to correspond to the number of functions defined in the relevant section below)
  • F: Number of internal dependencies

Reservoir characteristics

1|      |----------------------- SPEICHERKENNLINIE -------------------------|------|-----|------------|------------------------------|--------------------------------------------|
*|      |                              |  WSP     Volumen    Oberfl.        |      |     |            |                              |                                            |
*|      |                              |  mNN       [0-1]     ha           |      |     |            |                              |                                            |
*|      |------------------------------|-<----->-<-------->-<------>--------|------|-----|------------|------------------------------|--------------------------------------------|
 |      |                              |     208          0        0        |      |     |            |                              |                                            |
 |      |                              |     210 0.00032636        1        |      |     |            |                              |                                            |
 |      |                              |     215 0.01338076      7.5        |      |     |            |                              |                                            |
 |      |                              |     220 0.02676153     15.5        |      |     |            |                              |                                            |
 |      |                              |     225 0.05874482     29.7        |      |     |            |                              |                                            |
 |      |                              |     230  0.1220587     43.1        |      |     |            |                              |                                            |
 |      |                              |     235  0.2056069     63.9        |      |     |            |                              |                                            |
 |      |                              |     240  0.3348455       88        |      |     |            |                              |                                            |
 |      |                              |     245   0.499331    116.9        |      |     |            |                              |                                            |
 |      |                              |     250   0.719624    149.5        |      |     |            |                              |                                            |
 |      |                              |   251.8  0.8178584    162.5        |      |     |            |                              |                                            |
 |      |                              |     255          1    190.5        |      |     |            |                              |                                            |
*|      |------------------------------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------|
Attention!
There can only be a maximum of 40 supporting points (see #32). If more supporting points are entered, an error will occur. Fehler 2231:
 2231 Beim Systemelement .....................  XXXX
      bei den Funktionswerten fuer ...........  Vol
      muss der letzte Volumen-Wert = Smax sein!

Translations

WSP = water level
Volumen = volume
Oberfläche = surface area

Limit functions

2|      |------------------------- GRENZFUNKTIONEN -------------------------|------|-----|------------|------------------------------|--------------------------------------------|
*|      |                    |                                              |      |     |            |                              |                                            |
*|      |     Funktion       | lfd Fkt | Min-Wert Zeiger                    |      |     |            |                              |                                            |
*|      |                    | Nr. Kng |  m3/s    Nr.                       |      |     |    y-Pos   |                              |                                            |
*|      |<------------------>|-<->-<->-|-<------>-<->-----------------------|------|-----|-<-------->-|<-------------><------------->|--------------------------------------------|
 |      |         A             B   C        D     E                                            F             G              H                                                    |
*|      |--------------------|---------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------|
  • A: Description of the limit function
  • B: ongoing number (starts with 1)
  • C: Unique ID of function
  • D: minimum discharge
  • E: ???
  • F, G, H: nur für graphische Oberfläche

The function itself is defined in the FKT-File under its unique ID.

(Bei mir wurde der Wert für den minimalen Abfluss nicht ordnungsgemäß aus TALSIM exportiert! Froehlich 11:50, 9. Aug 2006 (CEST))

Reservoir surface area function

3|      |----------------- SPEICHEROBERFLAECHEN - FUNKTIONEN ---------------|------|-----|------------|------------------------------|--------------------------------------------|
*|      |                    |         |     |          |     |             |  (1) | (2) |            |                              |                                            |
*|      |     Funktion       |Bezug ist| Fkt |          | Kng | JGG WGG TGG |  QM  |Datei|            |                              |                                            |
*|      |                    | Oberfl. | Kng |          | 1/2 |  -   -   -  | mm/d | Nr. |            |                              |                                            |
*|      |<------------------>|---------|-<->-|----------|-<->-|-<->-<->-<->-|<---->|-<->-|------------|------------------------------|--------------------------------------------|
 |      |          A         |         |  B  |          |  C  |  D   E   F  |   G  |  H  |            |                              |                                            |
*|      |--------------------|---------|-----|----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------|

Reservoir surface area functions are inputs and outputs into/ out of the reservoir, which are proportional to the reservoir surface area, e.g. evaporation and precipitation out of or into the reservoir. Like this the calculation of the infiltration can be achieved in a simplified way.

  • A: Name/Description of the reservoir surface area function
  • B: Unique ID of the function
  • C: Calculation type: [1 | 2]

Calculation type 1: mean discharge with optional annual/ weekly/ daily pattern:

Calculation type 2: time series out of a file

  • H: Number of the utilized time series(defined in EXT-Datei)

Dam-reservoir regulation functions

4|      |----------------------- STEUER - FUNKTIONEN ---|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------|
*|      |                    |         |     |          |A    |(3,4,5)      |  (1) | (2) |            |                              |        W E R T E   A E N D E R U N G       |
*|      |     Funktion       |gibt KTR | Fkt | S Z F Grz| Kng |HYA  J  W  T |  QM  |Datei|            |      Achsenbeschriftung      |Kng|Intervall    Bezugsdatum   | konst.Gang |
*|      |                    |nach ID  | Kng | J/N   ID | 1-5 |ID   GG GG GG| m3/s | Nr. |   y-Pos    |    X-Achse       Y-Achse     |0-3|Typ Faktor   Bezugsdatum   |JGG WGG TGG |
*|      |<------------------>|<-->-<-->|-<->-|-+-+-+-<->|+<->-|<->-<-><-><->|<---->|-<->-|-<-------->-|<-------------><------------->|<->|<->-<---->-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     V  |        W       | X   Y   Z  |
*|      |--------------------|---------|-----|----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------|

The function itself is defined in the FKT-File under its distinctive identifier.

  • A: Name/Description of the dam-reservoir regulation function
  • B: ID the downstream receptacle, which receives the discharge(must be defined as downstream receptacle in theSYS-File!)
  • C: (optional) ID of the control function, with which the function shall be scaled (multiplied) (refer to -File)
  • D: unique ID of the function
  • E: Interpolation between supporting points? (J/N)
  • F: Interpolation in time? (J/N)
  • G: function-type
  • H: (optional) Number of the limit(ing) function(refer to limit functions), which is assigned to this dam-reservoir regulation function.
  • I: dam-reservoir regulation function active(J/N) (if no, the discharge of this function will be set to 0)
  • J: Calculation type (Scaletype):

Calculation type 0: direct discharge (does not work, refer to Bug 15)

Calculation type 1: mean discharge with optional annual/ weekly/ daily pattern:

Calculation type 2: time series:

  • P: Number of the utilized time series (defined in EXT-File)

Calculation type 3, 4 and 5: Hydraulics: overflow (3), pipe (4) and turbine (5):

  • K: ID of the hydraulic element (refer to theHYA-File, the calculation type chosen there must be identical with the chosen type here!)
  • Q, R, S: for graphical surfaces
  • T, U, V, W, X, Y, Z: Value alteration (?) (does not work, refer to Bug 5)

Internal dependencies

5|      |--------------------- INTERNE ABHAENGIGKEITEN ---------------------|------|-----|------------|------------------------------|--------------------------------------------|
*|      |                                                                   |      |     |            |                              |                                            |
*|      | Fkt |    QM   JGG WGG TGG |   Speicher  JGG WGG | Fkt Fkt Fkt Fkt |      |     |            |                              |                                            |
*|      | Kng |   cbm/s             |   Tsd.cbm           | Nam Nam Nam Nam |      |     |            |                              |                                            |
*|      |-<->-|--<---->-<->-<->-<->-|--<-------->-<->-<->-|-<->-<->-<->-<->-|------|-----|------------|------------------------------|--------------------------------------------|
 |      |  A  |>=   B    C   D   E  |<=     F      G   H  |  I   J   K   L  |      |     |            |                              |                                            |
*|------|-----|---------------------|---------------------|-----------------|------|-----|------------|------------------------------|--------------------------------------------|

A - E: First condition:

  • A: Function ID
  • B: Discharge, which must be surpassed in order for a reduction to occur
  • C, D, E: Number of the utilized annual/ weekly/ daily pattern to scale QM

F - H: Second condition:

  • F: reservoir volume,which must be undershot in order for a reduction to occur
  • G, H: Number of the utilized annual/ weekly pattern to scale the reservoir volume

I - L: function ID and order of the dam-reservoir regulation functions, which are to be reduced

Example

5|      |--------------------- INTERNE ABHAENGIGKEITEN ---------------------|------|-----|------------|------------------------------|--------------------------------------------|
*|      |                                                                   |      |     |            |                              |                                            |
*|      | Fkt |    QM   JGG WGG TGG |   Speicher  JGG WGG | Fkt Fkt Fkt Fkt |      |     |            |                              |                                            |
*|      | Kng |   cbm/s             |   Tsd.cbm           | Nam Nam Nam Nam |      |     |            |                              |                                            |
*|      |-<->-|--<---->-<->-<->-<->-|--<-------->-<->-<->-|-<->-<->-<->-<->-|------|-----|------------|------------------------------|--------------------------------------------| 
 |      | QH1 |>=     0             |<=     30641         | QM1 QM2 QM3     |      |     |            |                              |                                            |
Meaning
If the Discharge from QH1 is greater or equal to 0 and the reservoir volume is less or equal to 30641 thsd. m³, then reduce QM1 and if this is not sufficient, also reduce QM2 and then QM3 until a total reduction amounting to the value of QH1 has been achieved.