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 parameterIdscustom flag sources. For example to use in conditional aggregations

Function:

Configure predefined timesteps for a fews environmentcustom flag sources

Where to Use?

To define verbose timesteps or to define yearly or monthly time steps custom flag sources. Currently the conditional aggregations support the use of custom defined flagsources

Why to Use?

Yearly and monthly time steps can only be configured in the timesteps.xml. For verbose timesteps it might be
useful to define them once in the timestep.xml and refer to them from other configuration files.

Description:

Definition of timesteps which can be referenced from other configuration files

If the systeem needs additional flagsources, they can be defined by using the custom flagsources.

Description:

 

Available since:

2013.01 Available since:

Contents

Table of Contents

Overview

The timesteps.xml CustomFlagSources can be used to configure timesteps. This file is useful to define verbose timesteps and refer to the definition of these timesteps tofrom other configuration files.define custom flag sources. This can be usefull when the hard-coded flag sources are not sufficient. 

Configuration

When available on the file system, the name of the XML file is for example:

TimeSteps 1CustomFlagSources 1.00 default.xml

TimeSteps                                 Fixed CustomFlagSource                              Fixed file name for the TimeSteps configuration

...

Below the schema of the TimeStep.xml configuration files.

Image Added

Image Removed

timeStep

Attributes;

-         id: Unique Id of level threshold. This id should be used when referencing to this definition from other configuration files.

The following link describes in detail of to configure a timestep.

http://public.deltares.nl/display/FEWSDOC/02+Data+Handling+in+DELFT-FEWS#02DataHandlinginDELFT-FEWS-timeStep

yearlyTimeStep

A timeStep that defines a pattern of dates in a year. This pattern will be repeated every year.

Each date in the year can have a different aggregation period (season).

The start of the aggregation period is exclusive and the end of the aggregation period is inclusive.

This yearlyTimeStep is meant for seasons, therefore limited to four dates.

If more than four dates in a year are required, then please use the monthDays option in the timeStep element instead of this yearlyTimeStep

Schema yearly time step

Below the schema of the yearly time step

  Image Removed

Below a configuration example

...


	<yearlyTimeStep id="daily">
		<monthDay start="--01-01" end="--01-02" value="--01-02"/>
		<monthDay start="--04-02" end="--04-03" value="--04-03"/>
		<monthDay start="--07-03" end="--07-04" value="--07-04"/>
		<monthDay start="--10-04" end="--10-05" value="--10-05"/>
	</yearlyTimeStep>
Example

Below a configuration example

Code Block

<?xml version="1.0" encoding="UTF-8"?>
<customFlagSources 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/customFlagSources.xsd">
<customFlagSource id="10DF" flag="100" />
<customFlagSource id="10UR" flag="101" />
<customFlagSource id="20DF" flag="102" />
<customFlagSource id="20UR" flag="103" />
<customFlagSource id="50DF" flag="104" />
<customFlagSource id="50UR" flag="105" />
<customFlagSource id="CDF" flag="106" />
<customFlagSource id="CUR" flag="107" />
</customFlagSources>

To define a yearly time step an id should be configured. Secondly the monthDays of the time steps should be configured.
In this example the yearly time step has 4 monthDays. The start attribute defines the start of the aggregation period and the
end tag defines the end of the aggregation period. The value defines the value of the monthDay itself.

Monthly time step

A timeStep that defines a pattern of days in a month. This pattern will be repeated every month. Each day in the month can have a different aggregation period. The start of the aggregation period is exclusive and the end of the aggregation period is inclusive.

Schema monthly time step

Below the schema of the monthly time step.
Image Removed

Below a configuration example

Code Block
xmlxml

	<monthlyTimeStep id="example">
		<day start="01" end="02" value="02"></day>
		<day start="10" end="11" value="11"></day>
	</monthlyTimeStep>