Operations forecasting allows you to create alternate forecasts for inflows, water demands, stream flow losses and gains (unaccounted differences) and constituents within a single overall project scenario. In other words, it forecasts the input data for a model. 

The Operations simulation in Source is split into two phases - the historic 'warm-up' and the forecast period. The former is designed to warm-up the network's physical models by playing all known historic data into the system and overriding modelled values where applicable. In the latter, the Operations forecast models extend historic data into the future, effectively providing an estimate of the effect to the modelled system.

To create a default operations scenario in Source:  

• First, create a manager scenario; 
• Choose Tools » River Operations to open the River Operations dialog (Figure 1); and
• Click on the slider below Operations Mode to ON.  

Once you have created forecast models, you can disable operations, but retain these models or overrides using the buttons under Operations Data. The first two buttons in this dialog deal with removing input data, whereas the third one deletes all output data that was created for the forecast models. To clear all operations related data (input, output as a well as overrides), click Clear ALL Operations Data.

Figure 1. River Operations

Warming-up the model

Before you can begin forecasting, you must seed the model with available historical data (also known as "warming-up the model") using the Simulation toolbar:

• Choose Run w/Warm Up from the Select Analysis Type pop-up menu; and
• Click Configure.

This opens the Run w/Warm Up dialog (Figure 2).

Figure 2. Run w/Warm Up

Assuming a daily time-step:

• The Start Date and End Date fields define the limits of the available historical data in your model;
• The Warm Up Start date is set to the beginning of your historical data but you can change this if you intend to limit the warm-up process to a shorter time span;
• The date for Today is set to the last day of your historical data but you can also adjust this field as appropriate. Assuming your historical data is up-to-date (yesterday was the last day of historical data), this value should normally be today’s date so any difference might indicate a need to verify that all data has been loaded correctly into the model; and
• The Forecast Length defaults to 90 days. You would usually set this to the maximum travel time associated with your normal operations.

The + button can be used to step the operations scenario forward in time, which allows you to move from one day’s operational scenario to the next. You can also specify the data source using the Input Set drop down menu.

The remaining fields summarise what will occur when you complete the warm-up process. Click OK, and then Begin Analysis (Run) to begin the warm-up process.

Once the warm-up is complete, check the log for errors and resolve them. Refer to Using the Log Reporter. Then switch to the Tabular Editor (Figure 184) and inspect the results. Refer to Using the Tabular Editor.

Creating forecasts

Once operations has been enabled, you can configure the following forecast input data using the Forecasting list item in the node's feature editor:

• Additional flow at the Inflow node;
• Demand at the Time Series demand model;
• Unaccounted difference at the Gauge node; and
• Several parameters for the Storage node.

Forecast scenarios

A collection of one or more forecasting models is known as a forecast scenario. You can define one or more scenarios for each node. For example, you might define "wet year", "dry year" and "normal year" scenarios, or variations that reflect your most optimistic or pessimistic expectations. Forecast scenarios are unique to a node and can not be shared between nodes.

To create a forecast scenario, click Add (above the Forecast Scenario pop-up menu). This opens the Add Forecast Scenario dialog (Figure 128). Enter an appropriate name for your scenario and click OK.

Each forecast scenario that you create is placed in the Forecast Scenario pop-up menu and is then selected automatically. The controls in the Ops Forecast tab only affect the currently-selected forecast scenario. You can also apply a particular scenario forecast across all the scenario elements at a project level using Scenario tags. To edit a different forecast scenario, you must choose its name from the Forecast Scenario pop-up menu.

To rename an existing forecast scenario, first select the scenario that you wish to rename from the Forecast Scenario pop-up menu and then click Edit (above the Forecast Scenario pop-up menu). This re-opens the Add Forecast Scenario dialog (Figure 128). Enter a new name for your scenario and click OK.

To delete an existing forecast scenario, first select the scenario that you wish to delete from the Forecast Scenario pop-up menu and then click Remove (above the Forecast Scenario pop-up menu). The scenario is removed immediately without prompting for confirmation and the change can not be undone.

Forecasting models

Source supports the forecasting model types shown in Table 105, plus the ability to combine those models in an arbitrary order.

To add a forecasting model to the current forecast scenario, click Add (below the Forecast Scenario pop-up menu). This opens the Add New Forecast Model dialog (Figure 129):

• Enter an appropriate name for your model into the Name field;
• Choose the appropriate model type from the Model Type pop-up menu; and
• Click OK.

Each forecasting model that you add to a forecast scenario becomes a sub-tab within the Ops Forecast tab. Feature Editor 77 has four sub-tabs showing that four forecasting models have been defined. When you create a new forecasting model, its sub-tab is created and becomes selected automatically.

You can change both the name and the type of an existing forecasting model. To do either, select the sub-tab representing the model that you wish to adjust and then click Edit (below the Forecast Scenario pop-up menu). This re-opens the Add New Forecast Model dialog (Figure 129). Make the appropriate changes and click OK.

To delete an existing forecasting model, first select the sub-tab representing the model that you wish delete and then click Remove (below the Forecast Scenario pop-up menu). The forecasting model is removed immediately without prompting for confirmation and the change can not be undone.

Forecasting models are applied in the order reflected by the sub-tabs, beginning with the left-most sub-tab and moving to the right. To change the order in which a forecasting model is applied, first select the sub-tab that you wish to re-order and then use the < and > arrow buttons to move the sub-tab into the correct position.

Within each forecasting model, you have the choice of allowing the model to be applied to a fixed number of time-steps or all remaining time-steps. As forecasting models are applied, the first model that is encountered which applies to all remaining time-steps will be the final model to be executed. In other words, if you create more than one forecasting model in a scenario, you should define a fixed number of time-steps for all but the model represented by the right-most sub-tab.

To apply a forecasting model to an explicit number of time-steps:

• Select the sub-tab representing the forecasting model that you wish to adjust;
• Turn off All Remaining; and
• Set the Time Steps field to the appropriate number of time-steps.

Expression forecast

You can define an expression to return any value you choose for each time-step in the forecast period. For example:

• a fixed value; or
• a fixed proportion of a variable that is available to the expression editor.

Monthly Average forecast

Creating a monthly average forecast model allows you to enter an average forecast value, in megalitres per day, to be applied for the whole of each month. You can either enter the monthly average values by hand, or import the values from a .CSV file formatted as shown in Table 106.

To trend from "today" to the monthly average, turn on Trend to Value and enter a trend rate which is a real number greater than zero but less than one. The observed daily flow rate for the previous month and the number of days of the current month are used to determine the initial flow volume.

Time Series forecast

To specify a forecast based on a time series, you must do one of the following:

• load a time series;
• link to the results of running another scenario; or
• connect to a pre-existing data set stored in a database.

Time series are assumed to conform with the structure shown in Table 107. Note that any time-stamps contained in a time series are ignored. The observation in the first row of the time series is used for the first time-step of the forecast period, the observation in the second row for the second time-step, and so on, until either there are no more data rows in the time series or the simulation reaches the end of the forecast period.

Trend forecast

To specify a trend forecast, enter the target value in megalitres per day, and a trend rate which is a real number greater than zero but less than one.

Applying forecasts

Clicking Forecast (sel) executes the currently-selected forecast scenario. Clicking Forecast (all) executes all of the forecast scenarios that have been defined for the node.

Executing a forecast scenario is the equivalent of a run and produces results (see the Running scenarios chapter). Executing a forecast scenario also updates the both the Tabular Editor (Figure 184) and the Forecast Scenario Outputs tab (Feature Editor 78).

Viewing forecasts

The results of executing one or more forecast scenarios can be viewed by switching to the Forecast Scenario Outputs tab (Feature Editor 78). The tab contains both tabular and graphical representations. The data produced by each forecasting scenario is represented by both a trace on the graph and a column in the table. You can use a combination of the table’s horizontal scroll bar or adjust the boundary between the table and graph to bring specific data columns into view.

To view the results of forecasts applied to multiple nodes in a scenario, switch to the Tabular Editor (Figure 184) and inspect the results. Refer to Using the Tabular Editor.

Adjusting forecasts

Cells containing forecast data can be adjusted or overridden by over-typing their values in either the data columns on the left of the Forecast Scenario Outputs tab, or in the Tabular Editor. Cells that are dependent on an adjustment automatically recalculate in the same manner as a spreadsheet.

Note that Source only stores one time series of forecast overrides for a project. You can not define one set of forecast overrides for your first forecast scenario, and a different set for your second forecast scenario.

You can access Figure 130 using Edit > Forecasting Scenarios...

Where: month is the first three characters of the name of the month (eg "Jan")
value is the projected amount in megalitres per day for the associated month.

Where: date is the observation date (dd/mm/yyyy)
value is the projected amount (units are undefined) for the associated date.