TAL-File: Difference between revisions
Jump to navigation
Jump to search
m replace obsolete <bluem> tag |
|||
| Line 10: | Line 10: | ||
==General Information== | ==General Information== | ||
<bluem> | <source lang="bluem"> | ||
*Talsperren (*.TAL) | *Talsperren (*.TAL) | ||
*================== | *================== | ||
| Line 22: | Line 22: | ||
| T100 | 25060 | 30641 | 1 | 208 | 251.8 | 25060 | 255 | 30641 | | | T100 | 25060 | 30641 | 1 | 208 | 251.8 | 25060 | 255 | 30641 | | ||
*|------|------------|------------|-----|----------|-----------------------|-----------------------| | *|------|------------|------------|-----|----------|-----------------------|-----------------------| | ||
</ | </source> | ||
This segment is self-explanatory. If there is more than one dam this line must be repeated for each dam.<br/> | This segment is self-explanatory. If there is more than one dam this line must be repeated for each dam.<br/> | ||
| Line 38: | Line 38: | ||
==Number of functions== | ==Number of functions== | ||
<bluem> | <source lang="bluem"> | ||
0Funktionen für T100 | 0Funktionen für T100 | ||
*=================== | *=================== | ||
| Line 49: | Line 49: | ||
| A | B | C D E F | | | | | | A | B | C D E F | | | | | ||
*| |------------------------------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------| | *| |------------------------------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
</ | </source> | ||
*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) | ||
| Line 58: | Line 58: | ||
==Reservoir characteristics== | ==Reservoir characteristics== | ||
<bluem> | <source lang="bluem"> | ||
1| |----------------------- SPEICHERKENNLINIE -------------------------|------|-----|------------|------------------------------|--------------------------------------------| | 1| |----------------------- SPEICHERKENNLINIE -------------------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
*| | | WSP Volumen Oberfl. | | | | | | | *| | | WSP Volumen Oberfl. | | | | | | | ||
| Line 76: | Line 76: | ||
| | | 255 1 190.5 | | | | | | | | | | 255 1 190.5 | | | | | | | ||
*| |------------------------------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------| | *| |------------------------------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
</ | </source> | ||
;Attention! | ;Attention! | ||
: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: | :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: | ||
| Line 91: | Line 91: | ||
==Limit functions== | ==Limit functions== | ||
<bluem> | <source lang="bluem"> | ||
2| |------------------------- GRENZFUNKTIONEN -------------------------|------|-----|------------|------------------------------|--------------------------------------------| | 2| |------------------------- GRENZFUNKTIONEN -------------------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
*| | | | | | | | | | *| | | | | | | | | | ||
| Line 99: | Line 99: | ||
| | A B C D E F G H | | | | A B C D E F G H | | ||
*| |--------------------|---------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------| | *| |--------------------|---------|------------------------------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
</ | </source> | ||
*A: Description of the limit function | *A: Description of the limit function | ||
*B: ongoing number (starts with 1) | *B: ongoing number (starts with 1) | ||
| Line 112: | Line 112: | ||
==Reservoir surface area function== | ==Reservoir surface area function== | ||
<bluem> | <source lang="bluem"> | ||
3| |----------------- SPEICHEROBERFLAECHEN - FUNKTIONEN ---------------|------|-----|------------|------------------------------|--------------------------------------------| | 3| |----------------- SPEICHEROBERFLAECHEN - FUNKTIONEN ---------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
*| | | | | | | | (1) | (2) | | | | | *| | | | | | | | (1) | (2) | | | | | ||
| Line 120: | Line 120: | ||
| | A | | B | | C | D E F | G | H | | | | | | | A | | B | | C | D E F | G | H | | | | | ||
*| |--------------------|---------|-----|----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------| | *| |--------------------|---------|-----|----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
</ | </source> | ||
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. <br / > | 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. <br / > | ||
*A: Name/Description of the reservoir surface area function | *A: Name/Description of the reservoir surface area function | ||
| Line 132: | Line 132: | ||
==Dam-reservoir regulation functions== | ==Dam-reservoir regulation functions== | ||
<bluem> | <source lang="bluem"> | ||
4| |----------------------- STEUER - FUNKTIONEN ---|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------| | 4| |----------------------- STEUER - FUNKTIONEN ---|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
*| | | | | |A |(3,4,5) | (1) | (2) | | | W E R T E A E N D E R U N G | | *| | | | | |A |(3,4,5) | (1) | (2) | | | W E R T E A E N D E R U N G | | ||
| Line 140: | Line 140: | ||
| | 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 | | | | 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 | | ||
*| |--------------------|---------|-----|----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------| | *| |--------------------|---------|-----|----------|-----|-------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
</ | </source> | ||
The function itself is defined in the [[FKT-Datei|FKT-File]] under its distinctive identifier. | The function itself is defined in the [[FKT-Datei|FKT-File]] under its distinctive identifier. | ||
| Line 167: | Line 167: | ||
==Internal dependencies== | ==Internal dependencies== | ||
<bluem> | <source lang="bluem"> | ||
5| |--------------------- INTERNE ABHAENGIGKEITEN ---------------------|------|-----|------------|------------------------------|--------------------------------------------| | 5| |--------------------- INTERNE ABHAENGIGKEITEN ---------------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
*| | | | | | | | | *| | | | | | | | | ||
| Line 175: | Line 175: | ||
| | A |>= B C D E |<= F G H | I J K L | | | | | | | | | A |>= B C D E |<= F G H | I J K L | | | | | | | ||
*|------|-----|---------------------|---------------------|-----------------|------|-----|------------|------------------------------|--------------------------------------------| | *|------|-----|---------------------|---------------------|-----------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
</ | </source> | ||
'''A - E: First condition:''' | '''A - E: First condition:''' | ||
*A: Function ID | *A: Function ID | ||
| Line 186: | Line 186: | ||
===Example=== | ===Example=== | ||
<bluem> | <source lang="bluem"> | ||
5| |--------------------- INTERNE ABHAENGIGKEITEN ---------------------|------|-----|------------|------------------------------|--------------------------------------------| | 5| |--------------------- INTERNE ABHAENGIGKEITEN ---------------------|------|-----|------------|------------------------------|--------------------------------------------| | ||
*| | | | | | | | | *| | | | | | | | | ||
| Line 193: | Line 193: | ||
*| |-<->-|--<---->-<->-<->-<->-|--<-------->-<->-<->-|-<->-<->-<->-<->-|------|-----|------------|------------------------------|--------------------------------------------| | *| |-<->-|--<---->-<->-<->-<->-|--<-------->-<->-<->-|-<->-<->-<->-<->-|------|-----|------------|------------------------------|--------------------------------------------| | ||
| | QH1 |>= 0 |<= 30641 | QM1 QM2 QM3 | | | | | | | | | QH1 |>= 0 |<= 30641 | QM1 QM2 QM3 | | | | | | | ||
</ | </source> | ||
;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. | ;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. | ||
[[Category:BlueM.Sim input files]] | [[Category:BlueM.Sim input files]] | ||
Latest revision as of 10:57, 12 September 2026
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
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:
- D, E, F: Number of the annual/ weekly/ daily patternto be used
- G: Mean value of the function [mm/d is converted internaly to m³/s.ha]
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:
- L, M, N: Number of the utilized annual/ weekly/ daily pattern
- O: Mean discharge value
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.