Understanding the basic folder and file structure

  • Take some time to understand what files are stored where and why in the configuration
  • Understand the way how the configurations of different files are related to each other
  • Practise the file relations and the navigation to the related files (e.g. workflows & workflow descriptor etc.)
  • Create a (visual) overview containing the different functions of the files (e.g. explorer.xml, filters.xml, topology.xml etc.)
  • Create a (visual) overview of relations between configured elements and time lengths
  • The clientConfig.xml that is used to create a shortcut is placed under “RootConfigFiles”
  • If you create a short cut for an Operator Client or Config Manager place each of those in separate folder, not in your region home.

Understanding the system and configuration task

  • Follow the conventions used in a system
  • Use the Workflow Navigator to understand the system, especially helpful could be the right click -> Highlight Usage function
  • Make a list of every step that is required to get to the desired solution in advance
  • Create a (visual) overview of the problem implementation
  • Take into account how the configured element will be used by the end user
  • If available have a look at an example for your first configuration tasks.

Good to know in the FEWS GUI

  • The “Logs” window can be cleared by right clicking on it and press “clear messages”
  • Learn and use the most important short cuts from the beginning:

                In every display when the cursor is e.g. in the logs window

    • F12 is like a Swiss-Army-Knife: provides lots of options (e.g. open database viewer, make ids visible, etc.)
    • F5: reload configuration

                Manual forecast display

    • Ctrl r: run single modules in a workflow
    • Ctrl d: run modules of a workflow in debug mode
    • F12: provides several options (e.g. showing all workflows)

                Database viewer

    • F10: shows time series graphically (selecting a time series)
    • Right-click on a time series provides additional options

Data handling

  • Always reload the configuration in FEWS with F5 after making changes to the configuration.
  • When importing always check that the data is still available in the import folder.
  • Use a version tracking system like subversion for managing changes.
  • If not configured differently data from the import folder is deleted after the import → make a safety copy of the data in this case
  • To avoid that the data is deleted from the import folder in a testing phase it is possible to use “deleteImportedFiles = false” in the configuration
  • In case of mistakes or during debugging it might be useful to have a clear database viewer. First make a safety copy of the local data store (region home) to a separate folder.

          To clear the database viewer, it is possible:

    • To delete the whole local data store from the region home
    • To remove only certain data press F12 “Delete module instance for selection” the database viewer display
  • Making copies of the local data store is also a good way to safe the current data status of the system in case you would like to go back to that state later
  • Keep in mind that whether the data is shown in your data viewer, also depends on your current system time. Only data existing at the system time is shown.
  • Keep in mind that since the data is often first imported, then processed and then put into a model, there can be different time series for all this data
  • Use the database lister to see whether and how time series are written by a workflow 

Model integration

  • Keep in mind to start with the export activity in the general adapter module, because:
    • Export: fews > model,
    • Import: model > fews
  • The modules folder (region home) is constantly overwritten by the ModuleDataSetFiles→ it doesn’t make sense to change anything in the modules folder
  • For debugging it could be useful to run the model once outside Delft-FEWS 

  • No labels