Page History

...

Wanda is an advanced, interactive software package to support the hydraulic design process of your pipeline system. The program is used for the hydraulic analysis of steady and unsteady flow conditions in arbitrary configured pipeline networks.

Specific features

Combined pre- and post- adapter

A common practice for development of FEWS model adapters is to develop two separate adapters for pre- and post processing of model input and output. For Wanda this resulted in two adapters, the WandaPreadapter and WandaPostAdapter which use the PI-XML format to exchange data with FEWS.

On request of the users an additional, combined adapter has been added, the WandaAdapter which performs both the pre-and post processing tasks and also executes the Wanda Model. Using this combined adapter is more efficient because instead of 3 separate execute activities the General Adapter only needs to execute one and as a result the Wanda Java API used by the adapter only needs to load the Wanda Model schematization once, providing considerable performance improvement, especially for a large model. The configuration example examples given on this page therefore all assume that the combined WandaAdapter is used.

Exception handling

Some of the exceptions that may occur during transformations processing are logged as warnings in the configured diagnostics file without aborting the adapter processing.:

• location Id's for which a matching Wanda component cannot be found
• parameter Id's for which a matching Wanda property cannot be found for the selected Wanda Component
• time series that cannot be loaded for a selected component and property because the property has no defined series (Action table) in the wanda model

For other types of exception, the exception is logged and an exception i thrown so the adapter processing is aborted and the general real adapter will also log the error in the FEWS log.

Action tables

Wanda uses so-called Action tables to store input timeseries from FEWS, these need to be configured in the Wanda Schematization properly, The adapter will always first see if an Action table is found that uses the same name as the FEWS Parameter Id for the timeseries. If that is not the case, the default action Table with the name "Action table" is addressed, ignoring the Parameter Id from FEWS, in which case a Wanda component can only contains one property that contains a timeseries.

Wanda adapter binary folder

...

The Wanda model binaries currently consist of 221 files so this package is a bit large to list the complete content here. TODO: refer to source If you have access to the Wanda SVN repository a recent copy of the complete set for windows 64-bit systems can be found here: https://repos.deltares.nl/repos/wanda3/WandaApi/Trunk/Wanda.Java/test/bin

The Wanda Model folder can be placed in <Region>\Modules\Wanda\bin\wanda or other folder of your choice which can be configured separately from the adapter binaries using a property in the runinfo xml file.

...

ExportActivities Section

Important for the Wanda here model and the Wanda adapter are the properties of the exportRunFileActivity. These properties provide specific Wanda adapter and Wanda model settings.

• key - MODEL: this setting contains the path and file name of the Wanda Model input file to open (*.wdi) The model output file
  to be read by the adapter after completing the model run uses the same file name but the file extension *.wdo.
• key - BIN: this setting contains the path where the Wanda model binaries are stored.
• key - AMBIENTFILE (optional): a file name mask (can contain * wildcards) used to identify files listed under exportTimeSeriesActivity
  which contain ambient properties that are applied in a specific manner to all pipe objects in the Wanda model.
• key - GRIDPOINTSFILE (optionaoptional): a file name mask (can contain * wildcards) used to identify files listed under exportTimeSeriesActivity
  which contain gridpoint properties that are applied in a specific manner to grid points along a pipe object in the Wanda model.

In addition to the these  properties listed above , that provide specific information for the operation of the Wanda Adapter, it is also possible to set general proerties properties of the WandaModel Wanda model by defining the property name as key and a float, int or int string type value. This can be useful for example to control the Time step or Simulation time used by a Wanda model.

ExecuteActivities Section

...