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.
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 examples given on this page therefore all assume that the combined WandaAdapter is used.
Using the properties element in the combined Wanda adapter configuration, it is possible to directly set properties of the Wanda model, typically using the following property keys:
| Key | description |
|---|---|
| Time step | Time step in seconds (float) |
| Atmospheric pressure | Atmospheric pressure (float) |
| Vapour pressure | Vapour pressure (float) |
| Rheology type | "Newtonian" or "Slurry" (string) or 1 or 2 respectively (float) |
| Density | Density of the liquid (float) |
| Bulk modulus | Bulk modulus of the liquid (float) |
| Kinematic viscosity | Kinematic viscosity of the Liquid (float) |
| Visc. Coeff K in H-B model | For slurry model (float) |
| Exponent n in H-B model | For slurry model (float) |
Some of the exceptions that may occur during processing are logged as warnings in the configured diagnostics file without aborting the adapter processing.:
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.
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.
The following files are part of the binary folder for the Wanda adapter and are provided in the fews-wanda-adapter-bin.<version>.zip artifact of the "install adapters" teamcity builds:
A logical place would be <Region>\Modules\Wanda\bin
The Wanda model binaries currently consist of 221 files so this package is a bit large to list the complete content here. 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.
The image below shows an example of the configuration of the general section. The following settings are of specific importance for Wanda:
Important for Wanda here are the properties of the exportRunFileActivity. These properties provide specific Wanda model settings.
In addition to these properties, that provide specific information for the operation of the Wanda Adapter, it is also possible to set general properties of the Wanda model by defining the property name as key and a float, int or string type value. (see the table provided earlier)
The following image shows an example of the settings of the ExecuteActivities section in the general Adapter module. Wanda specific elements are:
The following image is an example of the importActivities section. An important element here is the exportPlaceHolderFile: this should be set to true.
Note that the adapter extract the output data from the wdo-file based on the content of the exportPlaceHolderFile (i.e. its locations, parameters and timestep)
Example general configuration file is attached (WarmingUP project)