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 example given on this page therefore all assume that the combined WandaAdapter is used.
Some of the exceptions that may occur during transformations 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.
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. TODO: refer to source
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 the properties listed above that provide specific information for the operation of the Wanda Adapter, it is also possible to set general proerties of the WandaModel by defining the property name as key and a float or int type value. This can be useful for example to control the Time step or Simulation time used by a Wanda model.
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)