...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
| Info | ||
|---|---|---|
| ||
This function is not available in Source (public version). |
...
Figure 1. Tabular Editor
Clicking the column title opens the Charting Tool for the node/link’s time series. This is synonymous to right clicking and choosing Time Series Graph from the contextual menu (Figure 1). Choosing Feature Editor opens the node/link’s feature editor that is associated with that column. Note that you can view lagged and storage routing statistics here as well (provided they are recorded when the scenario is run).
...
Figure 2. Show Column Editor (Column re-ordered)
Figure 3. Show Column Editor (Add group)
Customising the Tabular Editor
You can customise the Tabular Editor display to your needs. For each type of node or link, you can select:
- A background colour for the cell;
- A foreground colour and stylistic variation (eg. bold-face) for values displayed in the cell; and
- The number of decimal places to be displayed.
...
- To the entire table as a whole - by adjusting a set of user preferences. Refer to Tabular Editor Formatting. Changes made via this method apply to all projects; or
- To individual columns and cells - by right-clicking a column heading and choosing Column Formatting (refer to Customising columns). Changes made via this method only apply to the current project, and will override the Tabular Editor Format settings including templates.
...
- Individual column settings. Here, you can override project-related Tabular Editor Format Settings for the parameters displayed in the Tabular Editor (Figure 4);
- Create a header title (label) and choose the header colour for a column using the Header item (Figure 5); and
- Highlight when thresholds or rules are breached by specifying a function eg. Flow < 500 ML/day (Figure 6).
Figure 4. Column formatting
Figure 5. Column formatting, header
Figure 6. Column formatting, functions
Override Visualization Assistant
The Override function in Tabular Editor allows to change values for the editable parameters in historical and forecast period for an operation model. The override values will then be used to replace the previous cell value (s) in the modelling running, without overwriting the source data of previous cell value (s).
...
Figure 8. Override values in Data Source
|
|
For instance, time series data assigned to the flow of an inflow node can have missing values that the user can replace them in with new values in the operation Tabular Editor. However, if the time series of this node is used in multiple places in the model, the user can override the missing values through the time series “Data Source” in the Tabular Editor. This way the new values are propagated to all the usage of that Data Source in the model.
...
Add Additional Cutout Line: by configured color in Scenario options, it can highlight one discontinuous line, which shows the water travel time between the selected cell and relevant columns on Tabular Editor table.
...
Lock Cutout line: it can lock the Cutout for deletion.
Override Summary table
...
, including exporting and inputting override records
The Overrides Summary table can display manage all override values in the operation model. This function Its user interface can be accessed also from the Tabular Editor using the command button View Override Overrides (highlighted by the green box in Figure 7). Clicking on View Override Overrides will display a table the Overrides Summary editor (Figure 10) including with all existing override values such as 200/”Demo: add 200” on 19/04/2021for Dam’s rainfall value and comments respectively, the unchanged value (i.e. zero) for Dam: Unaccounted Difference on 19/04/2021.
Figure 10. Override Summary
Clear Historical Overrides: this command button will clear overrides values in .
The Overrides Summary editor displays six columns: Recorder Name, Override Date, Override Value, Units, Null Value, and Override Comment. Only the Override Value and Override Comment are editable from the Interface. The Editor interface has six command buttons to manage the override values: `
- Output: This command button allows for exporting all override records into a specified CSV file, which consists of the columns Recorder Name, Override Date, Override Value, Units, Null Value, Override Comment, and Recorder Key. Recorder Key collum is the unique ID.
- Input: The button allows for importing overrides from a specified CSV file to the Overrides Summary table. The inputted overridden data will only exist in the Overrides Summary table if “Apply” is not hit.
- Clear All Overrides: This button allows you to clear all override values in the Override Summary table, then in the Tabular Editor after Apply button is hit. This action is not reversed.
- Clear Historical Overrides: This button will clear override values in the whole historical period and will only display
...
- override values in the forecast period (from “tomorrow
...
- “only). The action is from values in the Override Summary table, then in the Tabular Editor after Apply button is hit. This action is not reversed
- Apply: The button can save the changes in the Overrides Summary table to the whole Tabular Editor (including changes made by Input/Clear ALL/Historic Overrides buttons and manually from the interface).
- Clear: The button can discard all changes made by Input/Clear ALL/Historic Overrides buttons or manually from the interface in the current Overrides Summary table.
Note that:
- Although the user can edit all contents of export/input CSV files outside of the Source, the user should only edit Override Value and Override Comment and never touch the Recorder Key.
- While importing, if the CSV contains multiple duplicate Recorder Key + Override Date + Override Value/Override Comment rows, that latest row will be considered for overriding.
- Errors occurring during the import/export will be displayed in the error bar at the top, as well as logged to the log reporter if required.
- If the user wants to edit the value of the unit in the CSV file, the user also needs to manually change the relevant Override Value. The input functionality does not automatically convert the relevant Override value between the old unit and the updated unit.
Figure 10. Override Summary
Minimum Flow Requirement nodes in Tabular Editor
Minimum Flow Requirement (MFR) nodes can now be accessed from the Tabular Editor and can be overridden. The recorder of Required Flow Arriving Current Timestep on MFR nodes was added to handle the complex concepts of the water flow due to the travel times. Required Flow Arriving Current Timestep recorder needs to be added to Tabular Editor as one column for Override if required (Figure 11). The user should override any cells in this column using the required flow that will arrive at the MFR node in the current time step considering the travel time. Another column/recorder of Required Flow is not editable in Tabular Editor and this Required Flow column reflects the default Required Flow, Forecast Required Flow and Overridden Required Flow at a source site (e.g., storage). The travel time in Figure 11 is three days and “today” in the operation model is 10/01/2000.
Figure 11. Override for Minimum Flow Requirement in Tabular Editor
Function Overridden in Tabular Editor
Now, the overridden functionality works for the Source function in Tabular Editor. This functionality is implemented for normal Source functions and not for custom functions (e.g. the functions from the MDBA plugin). The user can override the result of a function at one or more timesteps, and the override(s) will apply at the same Time of Evaluation as that function’s Time of Evaluation (EOT). This also applies to other functions that are referencing an original overridden function, and those functions will cite the overridden value(s) of the original function at the same EOT if their EOT is the same as that in the original function or after within the timestep.
The steps to set the function for overrides are below:
- Open Tabular Editor and Run a scenario (left screen capture in Figure 12).
- Open Tabular Editor Column Editor (right screen capture in Figure 12) by clicking on the Edit button (green highlighted on left screen in Figure 12).
- Add function(s) to Tabular Editor table for overridden (from right screen capture in Figure 12):
-Click on Functions (1 in the top-left panel) to select the type and show it to (2), and click on Functions (2) to show all functions in the model to the top-right panel.
-Tick the functions, which you want to override such as (3 in the top-right panel: $f_t_07_a and $f_t_07_b that is $f_t_07_a +10, in the top-right panel.
-Click on the Add Selected button (4 in Figure 12) to add the selected functions to the bottom panel (5 in Figure 12) and remove them from the top-right panel.
-Click on the OK button to close the interface and return to the Tabular Editor table.
- Run a scenario to display the original values of selected functions (left screen capture in Figure 12).
- Override the result/values of the functions (e.g. set 1,2,3 for $f_t_07_a to 10/06/2020, 11/06/2020,12/06/2020 respectively and 4,5,6 for $f_t_07_b to 16/06/2020, 17/06/2020, 18/06/2020 respectively).
- Run the scenario.
- Function values were overridden in Tabular Editor (left screen capture in Figure 12). The function values of $f_t_07_a from 10/06/2020 to 12/06/2020 were changed to 1, 2 and 3 (yellow highlighted in left screen) and $f_t_07_b values in the same period were also changed to 11,12 and 13 (orange highlighted in left screen as $f_t_07_b =$f_t_07_a +10) while $f_t_07_b values from 16/06/2020 to 18/06/2020 were changed to 4, 5 and 6 respectively (orange highlighted in left screen) and the function values of $f_t_07_a in the same period are not affected.
Figure 12. Override for Functions in Tabular Editor
