STILL DRAFT
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
This will result in:
|
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