The Inflow node allows you the user to define flows into your model. Inflows include runoff generated for defined headwater and residual catchment areas in the river system, point sources of water such as flow and/or constituent input to a Source model by adding point source inputs into a network. Inflows could include tributary inputs, inter-basin transfers, discharge from sewerage treatment plants, and return flows from water users, and inflows from irrigation drains and groundwater inflows. Inflows and constituents are specified as a time series. An inflow node is not used to account for rain falling directly on water bodies.
Feature Editor 6 shows the feature editor of an inflow node. You can describe inflows either by using an expression or by supplying a time series. Click Data Sources to load a time series in the node. Table 3 shows the format of a comma-separated (.CSV) file for providing time-series data.
Feature Editor 6. Inflow node (Additional Flow)
Forecasting inflows
Selecting Forecast (Feature Editor 7) allows you to forecast flows in two ways. Unlike Operations, it does not require a run of the warm period to initialise its calculations. The Operations Forecast Model is used in an ordering system, and determines how much flow might occur. These forecasts are needed in addition to what is in storages to determine how much water might be available to distribute in the current and coming days. As its name suugests, Recession Forecast Model creates a recession forecast model for the network defined in the Schematic Editor.
Feature Editor 7. Inflow node (Forecast)
Constituents
Prior to configuring constituents at an inflow node, ensure that they have been defined using . For further details on configuration, refer to Inflow node.
Table 3. Inflow node (data file format)
Row | Column (comma-separated) | |
---|---|---|
1 | 2 | |
1 | date | value |
Where: date is the date of observation in dd/mm/yyyy format (eg 31-12-2000)
value is the observed value (eg 2600)onto water storages (see the storage node description for this functionality).
Inflows, as specified by an inflow node, can contribute to supply of water orders. Inflows may also be ‘owned’ so may need to be taken into consideration when considering ownership and water accounting.
For explicit modelling of inflows and constituents please refer to the sections on flow generation and constituent generation.
Scale
The Inflow Node is implemented at the site-scale and represents a physical location on river network where point source inflows or constituents are added. The temporal scale is usually determined by the time-step of the input data. Common temporal scales are daily or monthly.
Principal developer
eWater CRC
Scientific Provenance
Gauge node was introduced in Source Rivers, WaterCAST and subsequently, Source Catchments.
Version
Source version 2.17
Dependencies
The inflow node must be part of a node link network.
Availability
Inflow node is automatically installed with Source.
Structure & processes
Time series of flow and constituents can be input to a model using the inflow node. Ordering and ownership functionality can apply to the water added via inflow nodes.
Basic function
The basic function of the Inflow node is to add water to a river network. Three techniques can be used to specify the inflow of water at an Inflow node:
- File
A time series of inflows can be loaded as a file which includes specification of a time stamp and the flow for each time stamp. For details on importing data files into Source, see the Source User Guide.
- Scenario
Flows can be imported from a scenario within the current project. This scenario must have been run for the data to be available.
- Expression
Flows can be specified as an expression in the expression editor.
Inflows can also be forecast, see the section on forecasting for details.
Time-step initialisation
Initialisation occurs before the order phase of the model commences. There are three steps to initialisation which are related to an inflow node. These steps occur in the following sequence:
- Where the inflow is defined using a time-series file or scenario the additional inflow for the current time-step is sourced.
- Where a forecast of inflows is made for use during the order phase. Inflows downstream of a storage are often considered by operators when determining releases required from the storage to meet orders. An operator can reduce the release from the storage on the basis that inflows downstream of the storage can be allocated to meet orders downstream of the inflow. Where there is a lag time between the storage and the point of inflow the operator will need to forecast what the inflows will be in the future. Source simulates this behaviour in the ordering phase. A number of forecasting models are available within Source and are detailed in the forecasting section of the SRG.
- Where the inflow is defined through an expression the additional inflow for the current time-step is determined.
Order Phase
The inflow node affects the Order Phase of a simulation if an inflow node is downstream of a storage and a forecasting model is used to make inflow predictions. In this case, the order passed up to the storage is reduced by the forecast inflow. Ordering is covered in more detail in Chapter 5.
If ownership is enabled, the forecast inflow is shared between owners based on a user defined ratio or expression. Where an owner does not require all of the share of the forecasted inflow (as their share is greater than their orders at that point) then they can lend their excess to other owners. Ownership is covered in more detail in Chapter 10.
Ownership off
Reduce current order by the unallocated forecasted inflow:
- For systems which do not have storage in parallel with different travel times, the unallocated forecasted inflow is equal to the forecasted inflow
- Otherwise, part or all of forecasted inflow may have been allocated. This is because orders may have been placed at previous time-steps with the same delivery time as orders being placed at the current time-step. In this case, the unallocated forecasted inflow is equal to the forecasted inflow minus inflow previously allocated.
Ownership on
Share forecasted inflow between owners based on ratio or expression
- For each owner, subtract any prior allocation of forecasted inflows at this delivery time to determine the unallocated forecasted inflow
- Reduce owner’s current order by the unallocated forecasted inflow
- Allow borrowing of any remaining unallocated forecasted inflow. See Section 10.3 for detail on borrowing systems
Flow Phase
All inflow nodes affect the flow phase. During the flow phase the total flow downstream of the node is increased based on the inflow at that time-step. The components of the downstream flow which are allocated and unallocated are also updated if forecasted inflows were allocated during the order phase.
Where enabled, the ownership of total flow and allocated and unallocated flow components are also updated during the order phase. Borrow and payback is also enabled during the flow phase which may be required when an owner’s inflow is different to that forecasted during the order phase.
Ownership off
When ownership is off:
- Determine the allocated and unallocated inflow at the inflow node:
- Determine the downstream total flow, allocated flow and unallocated as follows:
Ownership on
When ownership is on:
- Assign inflows to each owner based on ratio or expression.
- Determine the allocated and unallocated inflow for each owner as per step 1 for ownership off.
- If an owner’s allocated inflow was greater during order phase, the shortfall can be met by borrowing where other owners now have unallocated inflow. If there is not sufficient surplus to make up the shortfall, then downstream users, including downstream storages, need to be notified of the shortfall. How these shortfalls and paybacks are shared will be covered in the Ordering and Borrow and Payback sections.
Constituents
Constituents, either as time-series of loads or concentrations can be input from three sources:
- File
A time series of constituents can be loaded as a file which includes specification of a time stamp and the concentration or load for each time stamp. For details on importing data files into Source, see Chapter 10 of the Source User Guide.
- Scenario
Constituents can be imported from a scenario within the current project. This scenario must have been run for the data to be available.
- Expression
Constituents can be specified by an expression in the expression editor
The inflow of constituents must be accompanied by an inflow of water.
Where constituents are defined as a time series of concentrations the The inflow of constituents at an inflow node is defined by the equation:
Where:
Lxl(t) is the inflow load of constituent x for time-step t,
Cx(t) is the concentration of constituent x in the inflow stream at time t and
Ql(t) is the inflow at the node at time t.
The load of constituent from the inflow time series is added to the load of the same constituent at the node coming from other sources (such as the catchment upstream of that node). If the constituent inflow is the only node model applied at the node, then
Where:
Lx(t) is the load of constituent x at the node after addition of the inflow load and
Lx,US(t) is the load of constituent x coming from the link(s) upstream of that node.
It is assumed that the time series of flows, constituent loads and constituent concentrations are average values for each time-step that are entered (not instantaneous values at the start or end of the time-step). For each time-step then, the constituent load inflow at the node is the product of the flow inflow at the node and the constituent concentration at the node.
It is assumed that variations in constituent concentration / load within one time-step are ignored and that the average value across the time-step can be used to represent the processes.
The forecasting functionality that applies to flows is not available for constitutents.
Input data
Time series of flow and constituents data can be loaded into the input node. File formats are discussed in the Source User Guide.
At an inflow node, inflows are entered as a time-series for inflow volume per time-step of the model, eg ML/day or GL/month.
For constituents input, the constituent that the inflow node model is to be configured for must be specified and the input type (load or concentration) selected.
Time series data must have no missing values and ideally be for the same time period as other inputs into the model. There must be at least an overlapping period with other model inputs.
Constituent loads can not be negative (zero or positive real values only). This applies to the inflow constituent load, as well as to the load of constituents coming into the node from upstream link(s).
Parameters
Parameters are important for forecasting as explained in the forecasting chapter.
Output data
The output data is a time series of flow and or constituents.