Module Reservoirs - Revision history

Lucian: /* Outflows */

2017-03-28T15:06:49Z

‎Outflows

Davidbrito: /* Sample */

2017-03-15T13:33:07Z

‎Sample

Davidbrito: /* KEYWORDS */

2017-03-15T13:28:46Z

‎KEYWORDS

Davidbrito: /* Outflows */

2017-03-15T13:27:30Z

‎Outflows

Davidbrito: /* Outflows */

2017-03-15T13:27:19Z

‎Outflows

Davidbrito at 13:43, 2 November 2015

2015-11-02T13:43:38Z

Davidbrito: /* KEYWORDS */

2015-11-02T13:13:33Z

‎KEYWORDS

Davidbrito at 13:12, 2 November 2015

2015-11-02T13:12:42Z

Davidbrito: Created page with "==Overview== Module Reservoirs allows to compute reservois dynamic that change river flows and concentrations. Module Reservoirs recieves flows and concentrations from Module Dra..."

2015-11-02T12:46:11Z

Created page with "==Overview== Module Reservoirs allows to compute reservois dynamic that change river flows and concentrations. Module Reservoirs recieves flows and concentrations from Module Dra..."

New page

==Overview==
Module Reservoirs allows to compute reservois dynamic that change river flows and concentrations. Module Reservoirs recieves flows and concentrations from Module Drainage Network and gives flows and concentrations to the same module.

==Main Processes==
The reservoirs do not have a explicit geometry and are located in a given Drainage Network node (that will interact flows and concetrations with it.

===Hydrology===

The reservoirs minimum parameter is maximum volume (keyword MAX_VOLUME) and optionally minimum volume (keyword MIN_VOLUME, default is 0.0). Below minimum volume the reservoir does not discharge and above maximum volume the reservoir discharges the remainder so that volume does not get higher than maximum.

====Inflows====
The inflows are imposed by Drainage Network at the nodes where the reservoir are located.

====Discharges====
Via Module Discharges any discharge can be imposed (positive e.g. WWTP, or negative e.g. water abstraction for irigation).

====Surface Fluxes====
Surface fluxes as precipitation and evaporation are not computed yet but routines already exist for that purpose

====Outflows====

The outflows can be computed by defining several options:

'''Outflow Unmanaged Reservoir'''
1)
If the maximum volume is the only information available, the reservoir will not discharge untill complete full and there after will discharge the volume above maximum divided by time step.

2)
There is the option to define unmanaged reservoir as a weir (by keyword IS_WEIR : 1) and the reservoir outflow is defined by the weir equation (also defined in ModuleDischarges). Then the crest elevation and widht need to be defined.

'''Outflow Managed Reservoirs'''
1)
If beside the maximum volume only an environmental flow (keyword MIN_OUTFLOW) is defined, then above minimum volume the environmental flow will be discharged until it reaches the maximum volume and there after will discharge the volume above maximum divided by time step.

2)
If an operation curve is given (keyword OPERATION_TYPE), on the form of:
# level - outflow - OPERATION_TYPE : 1
# level - outflow = percentage of inflow - OPERATION_TYPE : 2
# percentage of res volume - outflow - OPERATION_TYPE : 3
# percentage of res volume - outflow = percentage of inflow - OPERATION_TYPE : 4

then the curve is read and the outflow computed based on actual reservoir volume or level. The outflow can be given directly from volume or level or the curve can define a percentage of inflow, where the outflow will be a percentage of the inflow at that instant.

The curves are given by <<beginoperation>> <<endoperation>> block wher first column is level (elevation) or percentage of reservoir volume and second column is outflow (m3/s) or percentage of inflow (0-1) and between defined points the model linearly interpolates.

If at any given instant the volume/level of the reservoir is below the lowest point of curves, it will impose environmental flow if available or zero.
If at any given instant the volume/level of the reservoir is above the highest point of curves, it will impose the last point outflow.

'''Reminder:''' if level is used an accumulated volumes curve is required (volume - elevation)) through a <<beginaccvolumecurve>> <<endaccvolumecurve>> block where first column is reservoir volume and second is elevation.

3)
There is also the option to impose the outflow (e.g. from measured data) where this is done via Module Discharges but the discharge needs to be negative and a keyword in discharge present (IS_OUTFLOW)

This management option will be given priority and will be used even that environmental flow or operation curves are defined.

@@ Line 28: / Line 28: @@
 )
-If the maximum volume is the only information available, the reservoir will not discharge untill complete full and there after will discharge the volume above maximum divided by time step.
+If the maximum volume is the only information available, the reservoir will not discharge until complete full and thereafter will discharge the volume above maximum divided by time step.
 )
-There is the option to define unmanaged reservoir as a weir (by keyword IS_WEIR : 1) and the reservoir outflow is defined by the weir equation (also defined in ModuleDischarges). Then the crest elevation and widht need to be defined.
+There is the option to define unmanaged reservoir as a weir (by keyword IS_WEIR : 1) and the reservoir outflow is defined by the weir equation (also defined in ModuleDischarges). Then the crest elevation and width need to be defined.
@@ Line 37: / Line 37: @@
 )
-If beside the maximum volume only an environmental flow (keyword MIN_OUTFLOW) is defined, then above minimum volume the environmental flow will be discharged until it reaches the maximum volume and there after will discharge the volume above maximum divided by time step.
+If beside the maximum volume only an environmental flow (keyword MIN_OUTFLOW) is defined, then above minimum volume the environmental flow will be discharged until it reaches the maximum volume and thereafter will discharge the volume above maximum divided by time step.
@@ Line 50: / Line 50: @@
 then the curve is read and the outflow computed based on actual reservoir volume or level. The outflow can be given directly from volume or level or the curve can define a percentage of inflow, where the outflow will be a percentage of the inflow at that instant or a percentage of maximum outflow (usually at maximum volume).
-The curves are given by <<beginoperation>>  <<endoperation>> block wher first column is level (elevation) or percentage of reservoir volume and second column is outflow (m3/s) or percentage of inflow or percentage of max outflow (0-1) and between defined points the model linearly interpolates.
+The curves are given by <<beginoperation>>  <<endoperation>> block where the first column is level (elevation) or percentage of reservoir volume and the second column is outflow (m3/s) or percentage of inflow or percentage of max outflow (0-1) and between defined points the model linearly interpolates.
 If at any given instant the volume/level of the reservoir is below the lowest point of curves, it will impose environmental flow if available or zero.

@@ Line 145: / Line 145: @@
   <beginreservoir>
   ID                        : 1
-  NAME                      : Reservoir
+  NAME                      : Reservoir Unmanaged
   DN_NODE_ID                : 4
   COORDINATES               : 825 325

@@ Line 106: / Line 106: @@
   MIN_VOLUME                         real    0.0     !Minimum reservoir volume - below no outflow
   MAX_VOLUME                         real    ...     !Maximum reervoir volume - above outflows remainder
-  OPERATION_TYPE                     int      4      !level - outflow                                             - OPERATION_TYPE : 1
+  OPERATION_TYPE                     int      4      !level - outflow                                                - OPERATION_TYPE : 1
-                                                     !level - outflow = percentage of inflow                      - OPERATION_TYPE : 2
+                                                     !level - outflow = percentage of inflow                         - OPERATION_TYPE : 2
-                                                     !percentage of res volume - outflow                          - OPERATION_TYPE : 3
+                                                     !percentage of res volume - outflow                             - OPERATION_TYPE : 3
-                                                     !percentage of res volume - outflow = percentage of inflow   - OPERATION_TYPE : 4
+                                                     !percentage of res volume - outflow = percentage of inflow      - OPERATION_TYPE : 4
   <<beginoperation>>                                 !Block to define operation curves
   <<endoperation>>
@@ Line 117: / Line 118: @@
   MIN_OUTFLOW                        real    0.0     !Enviromental flow
-  MAX_OUTFLOW                        real    inf     !Maximum outflow (limited by reservoir hudraulic structures)
+  MAX_OUTFLOW                        real    inf     !Maximum outflow (limited by reservoir hudraulic structures and mandatory in case of OPERATION_TYPE : 5)
   <endreservoir>

@@ Line 46: / Line 46: @@
 # percentage of res volume - outflow                             - OPERATION_TYPE : 3
 # percentage of res volume - outflow = percentage of inflow      - OPERATION_TYPE : 4
-# percentage of res volume - outflow = percentage of max outflow - OPERATION_TYPE : 4
+# percentage of res volume - outflow = percentage of max outflow - OPERATION_TYPE : 5
 then the curve is read and the outflow computed based on actual reservoir volume or level. The outflow can be given directly from volume or level or the curve can define a percentage of inflow, where the outflow will be a percentage of the inflow at that instant or a percentage of maximum outflow (usually at maximum volume).

@@ Line 95: / Line 95: @@
   INITIAL_VOLUME_DEFAULT_METHOD     int     1         !1 start perentage full
   START_PERCENTAGE_FULL             real    0.0       !read if INITIAL_VOLUME_DEFAULT_METHOD : 1. percentage of max volume at start
-−
-−
-−
   <beginreservoir>
   ID                                 int    ...      !Reservoir ID
@@ Line 113: / Line 113: @@
   <<beginoperation>>                                 !Block to define operation curves
   <<endoperation>>
-−
   <<beginaccvolumecurve>>                            !Block to define volume accumlated curves
   <<endaccvolumecurve>>
-−
   MIN_OUTFLOW                        real    0.0     !Enviromental flow
   MAX_OUTFLOW                        real    inf     !Maximum outflow (limited by reservoir hudraulic structures)

@@ Line 42: / Line 42: @@
 )
 If an operation curve is given (keyword OPERATION_TYPE), on the form of:
-# level - outflow                                             - OPERATION_TYPE : 1
+# level - outflow                                                - OPERATION_TYPE : 1
-# level - outflow = percentage of inflow                      - OPERATION_TYPE : 2
+# level - outflow = percentage of inflow                         - OPERATION_TYPE : 2
-# percentage of res volume - outflow                          - OPERATION_TYPE : 3
+# percentage of res volume - outflow                             - OPERATION_TYPE : 3
-# percentage of res volume - outflow = percentage of inflow   - OPERATION_TYPE : 4
+# percentage of res volume - outflow = percentage of inflow      - OPERATION_TYPE : 4
-then the curve is read and the outflow computed based on actual reservoir volume or level. The outflow can be given directly from volume or level or the curve can define a percentage of inflow, where the outflow will be a percentage of the inflow at that instant.
+then the curve is read and the outflow computed based on actual reservoir volume or level. The outflow can be given directly from volume or level or the curve can define a percentage of inflow, where the outflow will be a percentage of the inflow at that instant or a percentage of maximum outflow (usually at maximum volume).
-The curves are given by <<beginoperation>>  <<endoperation>> block wher first column is level (elevation) or percentage of reservoir volume and second column is outflow (m3/s) or percentage of inflow (0-1) and between defined points the model linearly interpolates.
+The curves are given by <<beginoperation>>  <<endoperation>> block wher first column is level (elevation) or percentage of reservoir volume and second column is outflow (m3/s) or percentage of inflow or percentage of max outflow (0-1) and between defined points the model linearly interpolates.
 If at any given instant the volume/level of the reservoir is below the lowest point of curves, it will impose environmental flow if available or zero.
@@ Line 62: / Line 63: @@
 This management option will be given priority and will be used even that environmental flow or operation curves are defined.
 ===Water Properties===

@@ Line 19: / Line 19: @@
 ====Surface Fluxes====
 Surface fluxes as precipitation and evaporation are not computed yet but routines already exist for that purpose
 ====Outflows====

@@ Line 27: / Line 27: @@
 '''Outflow Unmanaged Reservoir'''
 )
 If the maximum volume is the only information available, the reservoir will not discharge untill complete full and there after will discharge the volume above maximum divided by time step.
@@ Line 35: / Line 36: @@
 '''Outflow Managed Reservoirs'''
 )
 If beside the maximum volume only an environmental flow (keyword MIN_OUTFLOW) is defined, then above minimum volume the environmental flow will be discharged until it reaches the maximum volume and there after will discharge the volume above maximum divided by time step.
@@ Line 61: / Line 63: @@
 This management option will be given priority and will be used even that environmental flow or operation curves are defined.