Page History

Anchor
_Toc154574433 _Toc154574433

Anchor
_Toc95297287 _Toc95297287

Correlation Module Configuration

The Correlation Module is used to estimate a level at a downstream location through correlation of historical levels and discharges at specific upstream locations. This utility is provided through an interactive interface available on the operator client as well as for running automatically using a fixed correlation in the Forecasting Shell Server. The module may employ data from historical events at different locations as available in the central database

...

Correlation_Severn_Forecast 1.00 default.xml

Figure 82 Elements of the correlationSets configuration

correlationSet

Root element for defining a correlation to be applied..

inputTimeSeriesSet

Time series set to be used as input for the correlation. This time series set can either be a complete hydrograph (e.g. equidistant time series). It may also be a non-equidistant series of peaks sampled using a transformation module defined previously in the workflow.

outputTimeSerieSet

Time series set to be used as input for the correlation. Values are returned for the same time step as the input series.

correlation

Root element for the definition of a correlation

forecastLocationId

LocationId for the forecast location. This is the location to be defined in the output time series set.

equationType

Definition of the equation type to be applied in determining the correlation.

...

• equationType . Selection of equation type. Enumeration of options include
• polynomial
  
• simple_linear
  
• exponential_divide
  
• exponential_multiply
  
• power
  
• logarithmic
  
• hyperbolic
  
• polynomialOrder : Integer value for value of polynomial order. Applies only if polynomial equation is selected.
  

  eventSetsDescriptorId

  Id of the event sets to be used.  A suitable CorrelationEventSets configuration must be available (see below).
  

  travelTimesDescriptorId

  Id of the event sets to be used.  A suitable CorrelationEventSets configuration must be available (see below).
  

  eventSelectionType

  Method to be used in matching events. Events at the support and forecast location can be paired either on the basis of common EventId's, or on the basis of a selection on travel time, where events at the upstream and downstream location are paired if these are found to belong to the same hydrological event as defined using travel time criteria defined in the TravelTimes Configuration. Enumeration of options includes;
• eventid
• traveltime
  

  Comment

  Optional comment for correlation configuration. Used for reference purposes only.
  

  selectionCriteria

  Selection criteria used in defining events to be used in establishing correlations.
  
  Figure 83 Elements of the selectionCriteria configuration
  

  period

  Root element for defining selection of events based on dates.
  

  startDate

  Start date of time span to be used in selection (yyyy-MM-dd).
  

  endDate

  End date of time span to be used in selection (yyyy-MM-dd).
  

  startTime

  Optional start time of time span to be used in selection (HH:mm:ss)
  

  endTime

  Optional end time of time span to be used in selection (HH:mm:ss)
  

  selectInsidePeriod

  Boolean to indicate if events are to be selected that fall in the time span defined, or that fall outside the time span defined.
  

  thresholds

  Root element for defining selection of events that fall above or below a threshold. The threshold is applied to events selected at the forecast location.
  

  thresholdLimit

  Value of the threshold to use in selecting events.
  

  selectAboveLimit

  Boolean to indicate if events are to be selected that fall above the threshold if true. Events are selected below the threshold if false.
  

  tags

  Root element for defining selection of events on tags defined in the eventSets
  

  tag

  Definition of tag to use in event selection. Multiple tags may be defined.
  

  include

  Boolean to define if events with given tag are to be included or excluded in selection.
  

  Anchor
  _Toc154574434 _Toc154574434

  Anchor
  _Toc95297288 _Toc95297288

  CorrelationEventSets

  This configuration file is related to the Correlation module, and is used to define the events used in establishing a correlation. The configuration file is in the CorrelationEventSets (table or directory). Each configuration defined is referenced using a CorrelationEventSetsId as defined in the Regional Configuration.

Figure 84 Elements for defining correlationEventSets

comment

Optional comment for correlation event sets configuration. Used for reference purposes only.

correlationEventSet

Root element for defining set of events at a location to be used in establishing correlations.

locationId

LocationId for which events are defined

parameterId

ParameterId for which events are defined.

event

Definition of events at the specified location for the specified parameter.

...

• eventId : String ID for the event (may be used in matching events)
• value : value of the event
• date : event data (yyyy-MM-dd).
• time : event time (hh:mm:ss).
• tag : optional tag for event (may be used in event selection)

Location Attribute Based Events

Since 2019.01 it is possible to define correlation events based on (multivalued) location attributes.

...

ID,PAR,VALUE,TIME,ACTIVE
PH_locA,H.m,0.1,01-01-2001,true
PH_locA,H.m,0.2,02-02-2002,false
PH_locA,H.m,0.3,03-03-2003,true
PH_locA,H.sim,0.4,04-04-2004,false
PH_locA,H.sim,0.5,05-05-2005,true
PH_locA,H.sim,0.6,06-06-2006,true
PH_locB,H.m,1.1,11-10-2011,true
PH_locB,H.m,1.2,12-10-2012,false
PH_locB,H.m,1.3,13-10-2013,true
PH_locB,H.m,1.4,14-10-2014,false
PH_locB,H.sim,1.5,15-10-2015,true
PH_locB,H.sim,1.6,16-10-2016,false
PH_locB,H.sim,1.7,17-10-2017,false
PH_locB,H.sim,1.8,18-10-2018,true

Anchor
_Toc154574435 _Toc154574435

Anchor
_Toc95297289 _Toc95297289

TravelTimes

This configuration file is related to the Correlation module, and is used to define the travel time between locations. These travel times may be used in matching events. The configuration file is in the TravelTimes (table or directory). Each configuration defined is referenced using a TravelTimes Id as defined in the Regional Configuration.

Figure 85 Elements of the TravelTimes configuration

travelTime

Root element for defining a set of travel times. Multiple entries may exist.

downstreamLocation

LocationId of the downstream (forecast) location

...

• id : Id of the location
• name : name of the location (for reference purposes only)
  

  upstreamLocation

  LocationId of the upstream (support) location. Multiple entries may exist.

...

• id : Id of the location
• name : name of the location (for reference purposes only)
  

  travelTime

  Definition of the travel time between the location (average)

...

• unit unit of time (enumeration of: second, minute, hour, day, week)
• multiplier defines the number of units given above in a time step.**
• divider same function as the multiplier, but defines fraction of units in time step.**
  

  validPeriod

  Window around travel time for determining validity of event to be matched.

...