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