STILL DRAFT

Why use WC-on-the-fly?

  • 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.


Example of application configuration (Stand Alone WaterCoach)
<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:

  • 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


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


  • No labels