Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin


scrollbar


What

ratingCurves.xml

Description

Configuration for rating curves at specific locations

schema location

http

https://

fews

fewsdocs.

wldelft

deltares.nl/schemas/version1.0/ratingCurves.xsd

Entry in ModuleDescriptors

<moduleDescriptor id="Transformation">
<description>General transformation Component</description>

<className>nl.wldelft.fews.system.plugin.transformation.TransformationController</className>
</moduleDescriptor>

Rating Curves Module Configuration (Obsolete since 2009)

The ratings curve rating curves module is a standard file (i.e. it has a fixed name) which contains all the rating curves used in your system. It A rating curve is referenced by the location id. I.e. each location has a specific rating curve for that point in the river. Furthermore a rating curve can have one or more periods for which it is valid. For each location there can be different rating curves that are valid for different times.

When the transformation module needs to use a rating curve for a given location at a given time, then it will search all rating curves for the given location id. From all rating curves with the given location id, it will use the rating curve that is valid for the given time.

It is also possible to have different rating curves with the same location id, the same rating curve type and with overlapping valid periods, as long as they have different rating curve ids. This makes it possible to have rating curves with valid periods that only have a start date (no end date), which are valid until the next rating curve with the next start date becomes valid. In this case, if multiple rating curves are valid for a given time, then the transformation module will use the rating curve that has the most recent start date in its valid period.

The ratings are either "qhrelationtable" or "simpleratingcurve" refer to by the hydroMeteoFunction in the transformation module. An example of the reference from the transformation module is shown below:

Code Block

<hydroMeteoFunction function="qhrelationtable" outputVariableId="Flow" useRatingCurve="true" ratingCurveType="LevelToFlow"/>
or
<hydroMeteoFunction function="simpleratingcurve" outputVariableId="Flow" useRatingCurve="true" ratingCurveType="LevelToFlow"/>
Rating curve


Figure 1: Overview of rating curve config file

location for which the rating is valid should be the same as in the locations.xml
ratingCurveType you can choose from either LevelToFlow or FlowToLevel
reversible if this option is set to "true" then both level to flow and flow to level calculations with be allowed
ValidPeriod allows you to enter a start and end date for which the rating is valid (ie.eg. a summer and winter rating). The dates and times can be specified with or without a time zone. Use e.g. 2008-06-20T11:33:00+05:00 for a time in time zone GMT+05:00. Use e.g. 2008-06-20T11:33:00Z for a time in GMT, where the Z means GMT. If a time is specified without a time zone, e.g. 2009-12-01T00:00:00, then the time is assumed to be in local time. Note: 2008-06-20 11:33:00 in time zone GMT+5:00 is physically the same time as 2008-06-20 06:33:00 in GMT.
correction see below
ratingCurveTable see below
ratingCurveEquation see below

correction (not yet implemented)


Figure 2: correction complex type

...

The adjustment factor 1/S0vw (day/m) varies with water level. This factor is fitted by a parabolic function of h:

for h>hmin

Twin gauge station fall-discharge methods

Stage-fall-discharge or twin gauge station fall-discharge methods are user to include backwater effects on stage-discharge ratings.

In these methods the fall F between the water level at the discharge measuring site and a downstream station is considered as an additional parameter, to account for the effect of water surface slope on discharge. Both the constant fall method and normal fall method

Warning

add method here from hymos user manual!

normal fall method

are based on the following equation:

Image Added

Where:
Qm = backwater affected discharge
Qr = reference discharge
Fm = measured fall
Fr = reference fall
p = power, with 0.4 < p < 0.6

constant fall method

In this method the reference fall Fr is taken as a constant. A special case of the constant-fall method is the unit-fall method, where Fr = 1m is applied. In the computational procedure a value for Fr is assumed. Then a rating curve is fitted to the values:

Image Added

normal fall method

In this method the reference fall (Fr) is modelled as a function of the water level; Fr = f(h). This function is represented by a parabola:

Image Added

In Fews you should specify the a, b and c parameters and also a value of hmin, below which the backwater correction is not valid.

...

Rating Curve Table

ratingCurveTable this allows you to simply enter the pairs of q and h values.

Code Block
xml
xml

  </ratingCurve>
  <ratingCurve ratingCurveId="TheBigRiver">
    <location>
      <locationId>X1123</locationId>
    </location>
    <ratingCurveType>LevelToFlow</ratingCurveType>
    <reversible>true</reversible>
    <ratingCurveTable>
      <ratingCurveTableRecord flow="0.100" level="0.054"/>
      <ratingCurveTableRecord flow="0.500" level="0.155"/>
      <ratingCurveTableRecord flow="1.000" level="0.244"/>
      <ratingCurveTableRecord flow="1.479" level="0.317"/>
    </ratingCurveTable>
  </ratingCurve>
Rating Curve Equation

A rating curve equation can be defined per section of the rating curve using the lowerLevel and UpperLevel tags. The equation can be in the form of a power equation or a parabola. The form of the equation:

Power equation Image Added
Parabola Image Added

In Fews you should configure the appropriate values for a, b and c

Here is an example:

Code Block
xml
xml
  <ratingCurve ratingCurveId="Test location">
    <location>
      <locationId>234206</locationId>
    </location>
    <ratingCurveType>LevelToFlow</ratingCurveType>
    <reversible>true</reversible>
    <ratingCurveEquation>
      <lowerLevel>0</lowerLevel>
      <upperLevel>0.391</upperLevel>
      <equation>Power</equation>
      <a>11.9001</a>
      <b>0</b>
      <c>1.55067</c>
    </ratingCurveEquation>
    <ratingCurveEquation>
      <lowerLevel>0.391</lowerLevel>
      <upperLevel>0.807</upperLevel>
      <equation>Power</equation>
      <a>16.6258</a>
      <b>-0.1</b>
      <c>1.8564</c>
    </ratingCurveEquation>
  </ratingCurve>
Info
Under construction 18/08/2008 - More info on the rating curve equations to follow...