# TAL-File

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(refer to Bug 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.