Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Excerpt
hiddentrue

Functionality to define qualifiers to time series, next to locationIds and parameterIds

Function: Qualifiers to parameters

Configure topology of an IFD environment

Where to Use? Time series

Mandatory for a IFD installation

Why to Use?

The topology.xml is necessary to be able to use panels like the topology panel and the forecast panel To reduce the number of parameters

Description: Gives a qualifier to a parameter, like "minimum" of "observed"

Topology panel is used to define the topology of an IFD environment. Also the behaviour of the forecast panel which is used to start
IFD runs can be configured here.

Available since:

DelftFEWS200803 DelftFEWS201001

Contents

Table of Contents

Overview

The topology.xml is an mandatory configuration file when you are setting up an IFD-environment. This configuration file is used to configure the topology of a region.

The topology is defined by individual nodes. The topology can be viewed in the topology panel, which shows a block diagram of the topology, or in the forecast panel, which shows

a tree view of the topoloy. The behaviour of the forecast panel can also be configured in the topology-file. A workflow can be configured for a topology-node. By default the workflow will

run locally when the node is selected in the forecast panel. This can be switched off by setting the option enableAutoRun to false.

The topology.xml plays a central role in configuring an IFD-environment since it is used to configure the forecast panel which is the central panel in an IFD-environmentTo be able to give additional information to a parameter without creating lots of extra parameters, we introduced the feature of qualifiers. Qualifiers are used to define a unique time series, next to the locationId and parameterId. Examples are series where you want to derive the daily minimum, maximum and mean values of an observed series of water levels. The original series is a regular series with parameterId "H" and no qualifier, where the other series have  the same parameterId "H", but qualifiers like "min", "mean" and "max".

Configuration

Qualifier definition

Qualifiers are defined in the regionConfigFiles directory. An example looks like:

Code Block
xml
xml
<?xml version="1.0" encoding="UTF-8"?>
<qualifiers <topology xmlns="http://www.wldelft.nl/fews"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/qualifierstopology.xsd">

                <qualifier<nodes id="ABRFC">

                              <nodes id="minNMWTX" name="minNMWTX">

                                             <workflowId>NMWTX_Forecast</workflowId>

                                             <node  <description>minimum</description>
 id="EGLN5" name="EAGLE NEST DAM">

                                                            <workflowId>EGLN5_Forecast</workflowId>

                                             </qualifier>node>

                                             <node <qualifier id="maxCMMN5" name="maxCIMARRON 4SW">

                                                            <previousNodeId>EGLN5</previousNodeId>

                                                             <description>maximum</description>
  </qualifier>
</qualifiers><workflowId>CMMN5_Forecast</workflowId>

                                             </node>

                                             <node id="CMRN5" name="CIMARRON">

<localRun>false</localRun>

                                                            <workflowId>CMRN5_Forecast</workflowId>

                                             </node>

Time Series

The most useful way is first to read all locations from the DBF into one locationSet, where all attributes are assigned.
See for example:

...