View Source

STILL DRAFT

Operator would like to "rewatch" a recent event to analyze and learn
Trainer wants to prepare a WaterCoach Scenario without much effort
Trainer wants to inspect an event to determine the right period to "tag"

The WaterCoach-on-the-fly functionality was developed to allow users to quickly create a scenario for a training or review a historical event by playing it back in WaterCoach mode. The function requires that an Open Archive is coupled to the Stand Alone that the WaterCoach is used with, and that an eventType exists that contains the data types that one wants in a scenario.

The WaterCoach user guide explains how to use this function. The technical details are described on this page. it is first explained how to add this functionality to the WaterCoach display. Then follows an explanation of the FEWS functions that are leveraged under the hood. Finally, it is also detailed with which default settings are used, and how they depend on the available configuration.

How to configure the WaterCoach-on-the-Fly?

The on-the-fly functionality can be added to the normal WaterCoach Display by adding the <onTheFlySystem> element at the top of the WaterCoachDisplay.xml. Below config example shows the required and optional settings.

<onTheFlySystem>
		<eventTypeId>watercoach event</eventTypeId>		
		<importGridsAsReference visible="true" import="true"/>
		<importModelStates visible="true" import="false"/>
		<importModifiers visible="true" import="false"/>
</onTheFlySystem>

Settings of the started StandAlone with WaterCoach

The new instance will start up with the following settings:

use the Archives.xml of the StandAlone FEWS that kicked off the WaterCoach-on-the-fly session.
use the WaterCoachDisplay.xml from the downloaded configuration, or the file used in the starting Stand Alone if not found
- overrule the copyLocalDataStore setting with 'False' to allow a fast start up of the WaterCoach after the imports are finished.

How to use WC-on-the-fly

Open WaterCoach display
Select "Generate scenario"
Enter a Scenario name
Select "Start" and "End time"
Check options as required:
- Import grid as reference
- Import model states
- Import modifiers

This will result in:

Download of configuration form Archive
- Latest configuration before or at "Start time"
Launch a new Fews instance based on this
Download timeseries for selected period (linked to the "WaterCoach tag")
- Pop up with the volume of data that will be downloaded
- Data is automatically imported as well

DELFT-FEWS Documentation > WaterCoach-on-the-Fly configuration > image-2024-2-1_15-46-54-1.png

Launching generated Fews instance separately

It is possible to launch the generated Fews instance separately. In this way the downloading of the time series from Archive and importing into the localDatastore can be tested separately from the previous step that generates the new Fews configuration.

Use the following VM options:

-DscenarioScriptDatabasePath

-DwaterCoachDataStart

-DwaterCoachDataEnd

An example:

-DscenarioScriptDatabasePath=c:\WaterCoach_on_the_fly\TestA;importOptions=TFF

-DwaterCoachDataStart=28072023080000

-DwaterCoachDataEnd=28072023090000

scenarioScriptDatabasePath is a path to the generated Fews config.

With importOptions T or F (true or false) you specify the following 3 options : Import grids as reference, Import model states, Import modifiers.

waterCoachDataStart and waterCoachDataEnd specify the period for which the data should be downloaded from the Archive. The format is ddMMyyyyHHmmss.

These VM options can be configured in clientConfig.xml and in IntelliJ