Page History

Quick-start Guide for Adding an External Module in FEWS

This quick-start guide serves as an example processes for setting up an external module to run in FEWS. It includes the main tasks required to successfully implement any external module, but is in no way fully comprehensive for all modules. As every module is unique, more specific aspects may be required. There are wiki pages for Delft-FEWS Model adapters by Deltares supported by Deltares and there is an overview of  Models linked to Delft-FewsFEWS.
These steps do not necessarily need to be performed in the order presented.

...

Examples of the generalAdapter for several module adapters can be found here: Delft-FEWS Model adapters by Deltares

2. Add the generalAdapter to the moduleInstanceDescriptors.xml file

...

External modules in FEWS are structured in the following way:

%REGION_HOME%/Modules/ bin
                     / adapter_bin
                     / module_directory	Note: The module directory should be defined in with a moduleInstanceId

The module_directory/ may be configured in a variety of ways depending on the module structure. Here is an example:

module_directory / input	 toModel      Data from FEWS as input to the module
                 / output	 toFews       Data from the module as export to FEWS
                 / states	States to be passed between FEWS and the module
                 / diagnostics  Directory in which diagnostic files from the FEWS pre-and post adapters are written
                 / workDir	Directory in which module is run, including
                                  - static input files not passed by FEWS, such as bathymetry, observation points, etc.
                                  - model definition template file

...

More information can be found here: Configuring WorkFlows

11. Add the workflow to the workflowDescriptors.xml file

...

• Check the FEWS export activities
  • Check that the export activities section of the general adapter is configured for the correct time series and grid data sets
  • Examine the ImportIdMap ExportIdMap for parameter and location mapping.
  • Run the model outside of Delft-FEWS in a separate directory
  • Compare the input files generated by Delft-FEWS to the input files used previously
    
    • Are the formats consistent?  Are the headers the same?  Is the data the same?
    • If not, you may be using a different data format.  Check if this data format is compatible with FEWS.  If the format is correct, check the log files from the pre-adapter for more information.
• Check the external module
  
  • Run the model outside of Delft-FEWS, but use the input files generated by the pre-adapter
    
    • If the model doesn't run properly, examine the model log files for more information.
    • If the model does run properly and output is generated move to the next step.
• Check the FEWS import activities
  • Examine the output files from the model in native format
    
    • Do you see what you expect to see?  If not, re-examine the model input and log files.
  • Examine the files generated by the post-adapter (if any)
    • Check that the data format is compatible with FEWS, If the format is correct, check the log files from the post-adapter for more information.
  • Examine the ExportIdMap ImportIdMap for parameter and location mapping.
  • Check that the import activities section of the general adapter is configured for the correct time series and grid data sets
  • Use the Workflow Navigator and Database Viewer to determine if data is imported and present in the localDataStore

...