Skip to content

Transformation functions — data quality, selection & control flow

This page is the generated field list for the data quality, selection & control flow transformation functions — smoothing/filtering a series, tidal review, picking specific values out of a series (peaks, lows, extremes, a time slice), summarizing discrete events, resampling at fixed points, combining multiple sources into one series, branching on a condition, and correcting values against a reference. Part of the transformation function catalogue; see that page for the shared <transformationModule>/<transformation> mechanics these all sit inside.

Covers : filter (low-pass, Gaussian smoothing), review (tidal balance review, historical-error resampling), selection (peaks/lows/extremes, ensemble member selection, grid-to-scalar extraction — ~15 variants), events (discharge volume/duration/maximum per discrete event), sample (equidistant/day/Julian-day/single-time-step resampling), merge (~12 strategies to combine multiple input series into one — simple priority, weighted, gap-fallback, toggle, relations, synoptic, and more), conditional (critical-condition lookup), adjust (correct a computed discharge/stage against an observed reference).

Used inside : A <transformation>, <periodTransformation>, or <rangeTransformation> in a transformationModule file.

Config/ModuleConfigFiles/MergePrimaryBackup 1.00 default.xml
<?xml version="1.0" encoding="UTF-8"?>
<transformationModule xmlns="http://www.wldelft.nl/fews" version="1.0">
<transformation id="MergeGaugeSources">
<merge>
<simple>
<inputVariable>
<timeSeriesSet>
<moduleInstanceId>ImportPrimarySensor</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>H.obs</parameterId>
<locationId>Gauge01</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="hour" multiplier="1"/>
<readWriteMode>read only</readWriteMode>
</timeSeriesSet>
</inputVariable>
<inputVariable>
<timeSeriesSet>
<moduleInstanceId>ImportBackupSensor</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>H.obs</parameterId>
<locationId>Gauge01</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="hour" multiplier="1"/>
<readWriteMode>read only</readWriteMode>
</timeSeriesSet>
</inputVariable>
<outputVariable>
<timeSeriesSet>
<moduleInstanceId>MergePrimaryBackup</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>H.obs</parameterId>
<locationId>Gauge01</locationId>
<timeSeriesType>simulated historical</timeSeriesType>
<timeStep unit="hour" multiplier="1"/>
<readWriteMode>add originals</readWriteMode>
</timeSeriesSet>
</outputVariable>
<coefficientSet>
<reverseOrderInputTimeSeries>false</reverseOrderInputTimeSeries>
</coefficientSet>
</simple>
</merge>
</transformation>
</transformationModule>

Auto-generated from transformationTypes.xsd. Descriptions are the schema's own annotations.

Function <filter>

ElementTypeCardinalityDescription
lowPass FilterLowPassComplexType required Low pass filter for discrete functions (e.g. time series). This transformation calculates the following difference equation. y(t) = b0*x(t) + b1*x(t-1) + ... + bM*x(t-M) + a1*y(t-1) + ... + aN*y(t-N). Here x is the input, y is the output, t denotes time, b0 to bM are the feedforward coefficients and a1 to aN are the feedback coefficients.
gaussian FilterGaussianComplexType required Smoothing transformation based on a gaussian function.

Function <review>

ElementTypeCardinalityDescription
tidalCorrectionByMatchingAstronomicalNumber TidalCorrectionByAstronomicalNumberComplexType required This transformation corrects the events in a time series based on corrections from another time series. The events are matched by astronical number
stageReview AdjustStageRevComplexType required Divides the stage into equal ranges and calculates the difference between the forecast and the measured data for each range
tidalBalanceReview TidalBalanceReviewComplexType required Calculates the balance between observed and forecasted tides, creates estimates for future tides.
historicalErrorResampler HistoricalErrorResamplerComplexType required Resamples error for a forecast based on historical forecasts and observations.
tidalPeakCorrection TidalPeakCorrectionComplexType required Resamples error for a forecast based on historical forecasts and observations.

Function <selection>

ElementTypeCardinalityDescription
independentLows SelectionIndependentLowsComplexType required Finds the low values of the input time series and writes this to the output time series.
lows SelectionLowsComplexType required Finds the low values of the input time series and writes this to the output time series.
maximum SelectionMaximumComplexType required Finds the maximum value of the input time series and writes this to the output time series. The maximum value will be written at the same time as in the input time series. Ignores unreliable values. If multiple values are equal to the maximum, then the latest value is used.
minimum SelectionMinimumComplexType required Finds the minimum value of the input time series and writes this to the output time series. The minimum value will be written at the same time as in the input time series. Ignores unreliable values. If multiple values are equal to the minimum, then the latest value is used.
independentPeaks SelectionIndependentPeaksComplexType required Finds the peak values of the input time series and writes this to the output time series.
peaks SelectionPeaksComplexType required Finds the peak values of the input time series and writes this to the output time series.
timeToSelection TimeToSelectionComplexType required Calculates for each timestep in the output time series the time (in minutes) to/from the nearest data point in the input time series, which typically is the result of any one of the other selection transformations.
maximumAroundPeak MaximumAroundPeakComplexType required Finds for each peak time from inputPeaksVariable a maximum value from inputVariable. The maximum value is searched in a period configured with a time window
valuesAfterChangeWithTimeWindow SelectionValuesAfterChangeWithTimeWindowComplexType required Since 2013.01. FEWS-8585. Copies values from the inputVariable to the outputVariable under certain conditions. The specified conditionVariable is searched for changes during the run period of the transfomation. When the conditionVariable value changes, then a time window is created. This time window starts at the time of the change. The length of the time window (in seconds) is determined by evaluating the specified timeWindowLengthExpression at the time of the change. For each change in the conditionVariable a new time window is created (time windows can overlap). If the specified selectionType is select_inside_time_window, then all inputVariable values that are within at least one time window are copied to the outputVariable and all other inputVariable values are ignored. If selectionType is select_outside_time_window then all inputVariable values that are within at least one time window are ignored and all other inputVariable values are copied to the outputVariable. This can be used e.g. to filter out measurement values during periods where the measured system is not in a (quasi) steady state due to changes happening in the system. Produces missing output values at times where there is not enough reliable or doubtful data available in the condition and/or expression variables to determine if there is a change or to determine the length of a time window. Any such missing output values are truncated from the start and end of the run period of the transformation, to avoid overwriting data from previous runs with overlapping run periods.
astronomicalNumberForPeaksAndLows AstronomicalNumberSelectedPeakComplexType required Since 2016.01. This transformation should be used in combination with a transformation to calculate the peak or low for a tidal time series. For each calculated peak or low the astronomical number will be calculated.
ensembleMemberByIndex EnsembleMemberByIndexSelectionComplexType required Since 2019.01. Select value of the (ensemble) time series that matches with member index of input time series
gridEnsembleMemberByIndex SelectionGridEnsembleMemberIndexComplexType required Since 2020.02. This transformation function is used to calculate an output value based on a lookup table. This function uses 3 input variables to perform the lookup. Linear interpolation only, no extrapolation.Data source is csv file.
selectionScalarTimeSeriesFromScalarMap SelectionScalarTimeSeriesFromScalarMapComplexType required Since 2020.02. This transformation function extracts a scalar timesSeries from a scalar map series. If a range of domain values is defined instead of one value, the average of these values will be calculated as an output.
selectionScalarTimeSeriesLayersFromScalarMap SelectionScalarTimeSeriesLayersFromScalarMapComplexType required Since 2020.02. This transformation function extracts a scalar timesSeries from a scalar map series. If a range of domain values is defined instead of one value, the average of these values will be calculated as an output.
selectNumberedTidalPeaks SelectNumberedTidalPeaksComplexType required Since 2020.02. This transformation function selects actual tidal peaks based on a astrological tide input.
selectNumberedTidalLows SelectNumberedTidalLowsComplexType required Since 2020.02. This transformation function selects actual tidal lows based on a astrological tide input.
topographicProminencePeaks TopographicProminencePeaksComplexType required Since 2020.02. This transformation function selects actual tidal lows based on a astrological tide input.

Function <events>

ElementTypeCardinalityDescription
dischargeVolume EventsDischargeVolumeComplexType required Calculates either the volume or the maximum volume of the discharge values (m3/s) during the output period depending on the configured eventSelection. The volume is registered only in the output where the event started. In case of missing values, missing values are put in the output.
dischargeMeanVolume EventsDischargeMeanVolumeComplexType required Calculates the mean volume of discharge events (m3/s) that started in the output period. In case of missing values, missing values are put in the output.
duration EventsDurationComplexType required Calculates the duration of the events that started in the output period. If the maxGapDuration is not set to zero, periods smaller than the maxGapDuration (default 24h) will be added to the duration. In case of missing values, missing values are put in the output.
durationPerEvent EventsDurationPerEventComplexType required Calculates the length of each event found in the input time series.
maximum EventsMaximumComplexType required Calculates the maximum input value for events that started in the output period. In case of missing values, missing values are put in the output.
numberOfEvents EventsNumberOfEventsComplexType required Counts the events that initiated in the output period. In case of missing values, missing values are put in the output.

Function <sample>

ElementTypeCardinalityDescription
daySample DaySampleComplexType required Samples the input timeseries to a dayly timeseries using the time of T0 to determine the sampling moment. Output variable should be a non-equidistant simulated timeseries to accommodate shifting sampling times.
dayMonthSample DayMonthSampleComplexType required Samples the input timeseries to a day month output timeseries using the day-month of T0 to determine the sampling moment. Output variable should be a non-equidistant simulated timeseries to accommodate shifting sampling times.
julianDaySample JulianDaySampleComplexType required Since 2013.01. FEWS-8576. samples the input time series to the output time series using the Julian Days.
equidistant SampleEquidistantComplexType required Transform equidistant to another equidistant or to nonEquidistant time series.
historical SampleHistoricalComplexType required
nonEquidistant SampleNonEquidistantComplexType required Transform nonEquidistant to equidistant time series.
nonEquidistantSingleValue NonEquidistantSingleValueComplexType required For each time step in the reference time series a value is retrieved
sampleSingleTimeStep SampleSingleTimeStepComplexType required For each time step in the reference time series a value is retrieved

Function <merge>

ElementTypeCardinalityDescription
interpolation MergeInterpolationComplexType required Since 2017.02. Merges input time series with different grids to a single output grid by using a configured spatial interpolation.
mean MergeMeanComplexType required Merges mean time series with different time steps to a merged mean time series
relations MergeRelationsComplexType required Since 2013.01. FEWS-8619: Merges input data that is defined using one or more configured relations (expressions). Each relation contains a period for which it is valid and a free format expression that is used to determine the output value for that relation. If for a given time step the first relation produces a missing value, then the next relation is used. If that also produces a missing value, then the next relation is used, and so on, until a non-missing output value is found. The output time series contains for each time step the configured output comment (optional) of the relation that was used to determine the value for that time step. If all relations produce a missing value for a given time step, then the output for that time step is a missing value.
simple MergeSimpleComplexType required Merges input time series.
oneToMany MergeOneToManyComplexType required Merges input time series which are allowed to have one to many relations which can lead to multiple input series per input variable
synoptic MergeSynopticComplexType required Merges synoptic time series (data values that are accumulations over overlapping periods of time) to a time series with hourly data values.
toggle MergeToggleComplexType required Merges input time series. If input time series contains a gap larger than maxGapLength, then it will be replaced (toggled instead of merged) with the next input time series in the hierarchy.
gap MergeGapComplexType required Merges input time series. If input time series contains a gap larger than maxGapLength, then it will be replaced with the next input time series in the hierarchy.
weighted MergeWeightedComplexType required Merges two input time series with weights that are a function of time.
selectLocation MergeSelectLocationComplexType required Selects an input time series based on the value of an attribute.
selectDataSource MergeSelectDataSourceComplexType required Selects a data source based on the value of an attribute.
copy MergeCopyComplexType required Since 2021.02, copies copyFlags and/or copyFlagSourceColumns.

Function <conditional>

ElementTypeCardinalityDescription
multiple CriticalConditionalLookupTransformationComplexType required This function determines if one of the configured conditions is valid, if this is the case the ruleIndex which identifies this conditions is written to the output Time Series

Function <adjust>

ElementTypeCardinalityDescription
adjustQ AdjustQComplexType required Adjusts the simulated discharge values by using instantaneous discharge values and/or mean daily discharge values. If both time series are available both time series will be used in the adjustment procedure.
adjustQUsingMeanDailyDischarge AdjustQUsingMeanDailyDischargeComplexType required Adjusts the simulated discharge values by using mean daily discharge values.
adjustQUsingObservedInstantaneousDischarge AdjustQUsingObservedInstantaneousDischargeComplexType required Adjusts the simulated discharge values by using instantaneous discharge values.
adjustStage AdjustStageComplexType required adjust the forecast with the input from stagerev
adjustTide AdjustTideComplexType required Adjusts the tidal time series by using the adjustments created by operation tideBalanceReview

FilterLowPassComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
inputVariable InputVariableComplexType required Input variable (x). If one or more of the required (previous) input values for a calculation are NaN, then the output value will be NaN.
outputVariable OutputVariableComplexType required Output variable (y). If one or more of the required previous output values for a calculation are NaN, then these will be ignored, effectively this means that it behaves as if all previous NaN output values would be 0.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
coefficientSet FilterLowPassCoefficientSetComplexType required · repeats One or more coefficientSets that are valid for different ranges of the defined limit variable. Ranges should not overlap.
coefficientSetFunctions FilterLowPassCoefficientSetFunctionsComplexType required A coefficientSetFunctions object. This is similar to a coefficientSet object, only the value elements are replaced by function elements. A function is an expression, e.g. "@N@ / 1000", in which tags between "@" signs refer to location attributes that are defined in the locationSets config file. The expression is evaluated after replacing the tags by actual values. These values can be different for different locations and time periods.
coefficientSetId idStringType required Identifier of a coefficientSet to use. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.
coefficientSetFile fileStringType required Name of the file that contains the coefficientSet to use. This name should not include the file extension. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.

FilterGaussianComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
inputVariable InputVariableComplexType required
outputVariable OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
coefficientSet FilterGaussianCoefficientSetComplexType required · repeats CoefficientSet wich can be used to configure the bandwidth
coefficientSetFunctions FilterGaussianCoefficientSetFunctionsComplexType required A coefficientSetFunctions object. This is similar to a coefficientSet object, only the value elements are replaced by function elements. A function is an expression, e.g. "@N@ / 1000", in which tags between "@" signs refer to location attributes that are defined in the locationSets config file. The expression is evaluated after replacing the tags by actual values. These values can be different for different locations and time periods.
coefficientSetId idStringType required Identifier of a coefficientSet to use. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.
coefficientSetFile fileStringType required Name of the file that contains the coefficientSet to use. This name should not include the file extension. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.

TidalCorrectionByAstronomicalNumberComplexType

Calculates the balance between observed and forecasted tides and creates estimates for future tides.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
modelCorrections InputVariableComplexType required
modelOutput InputVariableComplexType required
correctionTimeLocationAttribute idStringType optional The calculated astronomical number can be corrected based on the value of the configured location attribute
correctedModelOutput OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

AdjustStageRevComplexType

Divides the stage into equal ranges and calculates the difference between the forecast and the measurements for each range

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
observedStage InputVariableComplexType required Input variable with the observed stage (water level) values.
forecastStage InputVariableComplexType required Input variable with the computed stage (water level) values.
averageBalanceFirstSegment OutputVariableComplexType required Balance for the first segment. The first segment is segment with the lowest stage ranges
averageBalanceSecondSegment OutputVariableComplexType required Balance for the second segment
averageBalanceThirdSegment OutputVariableComplexType required Balance for the third segment
averageBalanceFourthSegment OutputVariableComplexType required Balance for the fourth segment
startFirstStageRange OutputVariableComplexType required start of the first segment
startSecondStageRange OutputVariableComplexType required end of the first segment and the start of the second segment
startThirdStageRange OutputVariableComplexType required start of the third segment
startFourthStageRange OutputVariableComplexType required start of the fourth segment
endFourthStageRange OutputVariableComplexType required end of the fourth segment
maxDifference float optional If the difference between the forecast stage and the observed stage is larger then the maxDifference this difference will not be used for the calculation of the average balance.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

TidalBalanceReviewComplexType

Calculates the balance between observed and forecasted tides and creates estimates for future tides.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
observedTidalStage InputVariableComplexType required
forecastTidalStage InputVariableComplexType required
tideBalance OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

HistoricalErrorResamplerComplexType

Resamples error for a forecast based on historical forecasts and observations.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required The TimeSeries (forecast) to be resampled.
historicalSimulatedInputVariable InputVariableComplexType required Used in combination with historicalObservedVariable to determine the error at the historical match.
historicalObservedInputVariable InputVariableComplexType required Used in combination with historicalSimulatedVariable to determine the error at the historical match.
historicalStartDate DateTimeComplexType required The start date and time for the period in which is searched for a historical match. This has effect on both the historicalSimulatedVariable and historicalObservedVariable, but also on all featureVectorHistoricalSimulatedVariable elements.
historicalEndDate DateTimeComplexType required The end date and time for the period in which is searched for a historical match. This has effect on both the historicalSimulatedVariable and historicalObservedVariable, but also on all featureVectorHistoricalSimulatedVariable elements.
nearestNeighborPoolSize nonNegativeInteger required When searching for the historical match, X closest neighbours are used of which one is randomly selected. X is the nearestNeighbourPoolSize.
resamplingTrigger nonNegativeDouble required After the historical match has been determined, the feature vector distance between historical match and the forecast date is calculated. If the feature factor distance between the next forecast date (forecast date + X timesteps) and the historical match (hisorical match + X timesteps) is greater then the distance between the forecast date and historical match times the resampling trigger, a new historical match will be searched. Otherwise, the error at the histrical match will be used for the forecast date + X timeSteps.
attributeLocationId idStringType required The locationId is used as a reference location for use with modifiers. All weights and timeshift are associated with this locationId.
outputVariable OutputVariableComplexType required The input forecast with uncertainty added.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
featureVectorHistoricalSimulatedInputVariable InputVariableComplexType required Variable used to compare to the forecast date to calculate the feature vector distance.
featureVectorForecastInputVariable InputVariableComplexType required Variable used to compare to the historical dates (potential historical matches) to calculate the feature vector distance.
featureVectorWeight floatStringAttributeType required The weight that is used for this dimension when calculating the direction and magnitude of the feature vector.
featureVectorTimeShift intStringAttributeType required Shifts the time for both the historical simulated and forecast variable with X time steps for this feature vector dimension only.

TidalPeakCorrectionComplexType

Resamples error for a forecast based on historical forecasts and observations.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputObservedPeakVariable InputVariableComplexType required Observed peaks
inputAstroVariable InputVariableComplexType required Predicted astronomical
inputAstroPeakVariable InputVariableComplexType required Predicted astronomical peaks
inputSurgeForecastVariable InputVariableComplexType required Multiple forecast input variable
surgeSearchPeriod RelativePeriodComplexType required Period for which the surge forecasts should have their forecast time within
peak PeakCorrectionComplexType required · repeats Specifies which peaks should be included in the calculation.
correctionConstantAttributeId idStringType required Id of location attribute which contains the constant value that needs to be added to the correction value.
inputPeakSelectionVariable tidalPeakCorrectionInputSelectionEnumStringType required Variable that should be used to select the peaks, either observed or astro
One of: observed, astro
inputTimeSelectionVariable tidalPeakCorrectionInputSelectionEnumStringType required Variable that should be used to select the exact time of the peaks, either observed or astro
One of: observed, astro
outputPeak OutputPeakCorrectionComplexType optional Settings for output peak, like peakNumber which determines to which peak after T0 the correction should be applied
outputVariable OutputVariableComplexType required Correction value suggested for the next peak prediction
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

SelectionIndependentLowsComplexType

Finds the low values of the input time series and writes this to the output time series.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required
forecastLoopSearchPeriod RelativePeriodComplexType optional Period in which forecasts should be searched to loop over
gapLengthInSec nonNegativeInteger required
outputVariable OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
totalNumber positiveInteger required total number of elements
totalNumberBeforeT0 nonNegativeInteger required total number of elements before time zero
totalNumberAfterT0 nonNegativeInteger required total number of elements after time zero
skipJustBeforeT0 nonNegativeInteger optional number of elements to skip just before time zero
skipJustAfterT0 nonNegativeInteger optional number of elements to skip just after time zero

SelectionLowsComplexType

Finds the low values of the input time series and writes this to the output time series.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required
outputVariable OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
totalNumber positiveInteger required total number of elements
totalNumberBeforeT0 nonNegativeInteger required total number of elements before time zero
totalNumberAfterT0 nonNegativeInteger required total number of elements after time zero
skipJustBeforeT0 nonNegativeInteger optional number of elements to skip just before time zero
skipJustAfterT0 nonNegativeInteger optional number of elements to skip just after time zero

SelectionMaximumComplexType

Finds the maximum value of the input time series and writes this to the output time series. The maximum value will be written at the same time as in the input time series. Ignores unreliable values. If multiple values are equal to the maximum, then the latest value is used.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required
selectNumberOfHighestMax positiveInteger optional The number of highest maximum values to write to the output time series.
outputVariable OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

SelectionMinimumComplexType

Finds the minimum value of the input time series and writes this to the output time series. The minimum value will be written at the same time as in the input time series. Ignores unreliable values. If multiple values are equal to the minimum, then the latest value is used.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required
selectNumberOfLowestMin positiveInteger optional The number of lowest minimum values to write to the output time series.
outputVariable OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

SelectionIndependentPeaksComplexType

Finds the peak values of the input time series and writes this to the output time series.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required
forecastLoopSearchPeriod RelativePeriodComplexType optional Period in which forecasts should be searched to loop over
gapLengthInSec nonNegativeIntegerStringType required gap length in seconds
outputVariable OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
totalNumber positiveInteger required total number of elements
totalNumberBeforeT0 nonNegativeInteger required total number of elements before time zero
totalNumberAfterT0 nonNegativeInteger required total number of elements after time zero
skipJustBeforeT0 nonNegativeInteger optional number of elements to skip just before time zero
skipJustAfterT0 nonNegativeInteger optional number of elements to skip just after time zero

SelectionPeaksComplexType

Finds the peak values of the input time series and writes this to the output time series.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required
outputVariable OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
totalNumber positiveInteger required total number of elements
totalNumberBeforeT0 nonNegativeInteger required total number of elements before time zero
totalNumberAfterT0 nonNegativeInteger required total number of elements after time zero
skipJustBeforeT0 nonNegativeInteger optional number of elements to skip just before time zero
skipJustAfterT0 nonNegativeInteger optional number of elements to skip just after time zero

TimeToSelectionComplexType

Calculates for each timestep in the output time series the time (in minutes) to/from the nearest data point in the input time series, which typically is the result of any one of the other selection transformations.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required
outputVariable OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

MaximumAroundPeakComplexType

Finds for each peak time from inputPeaksVariable a maximum value from inputVariable. The maximum value is searched in a period configured with searchWindowInDays

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required Series the maximum value should be searched in
inputPeaksVariable InputVariableComplexType required Nonequidistant series with peaks
maximumAtActualTime OutputVariableComplexType required Nonequidistant series with maximum values found. The maximum values are stored at actual time of the max value.
maximumAtPeakTime OutputVariableComplexType optional Nonequidistant series with maximum values found. The maximum values are stored at peak times
valueDifference OutputVariableComplexType optional Nonequidistant series with differences between the input peaks and the maximum found for the peaks. The value difference is stored at peak time.
timeDifference OutputVariableComplexType optional Nonequidistant series with differences between the input peak times and the times of the found maximum. The time difference is stored at peak time. If 'timeWindow' is used, the values are stored in millis. If 'timeWindowInWholeDays' is use the values are stored in whole days.
className nameStringType optional
timeWindow TimeSpanComplexType required The maximum will be searched in this period : 'time of the peak - timeWindow' up to and including 'time of the peak + timeWindow'
timeWindowInWholeDays nonNegativeInteger required The maximum will be searched in this period : 'day of the peak - timeWindowInWholeDays' up to and including 'day of the peak + timeWindowInWholeDays'

SelectionValuesAfterChangeWithTimeWindowComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
variableDefinition InputVariableExpressionBasedFunctionComplexType optional · repeats Definitions of variables that can be used as input in this transformation. A variable is always a time series. Alternatively variables can be defined at the start of this transformations file. The variables that are defined here can be used as inputVariable, as conditionVariable, as outputVariable and/or in the timeWindowLengthExpression.
inputVariable InputVariableComplexType required Input variable. This contains the times and values that are copied to the output variable if they are selected by this transformation.
conditionVariable InputVariableComplexType required This condition variable is searched for changes during the run period of the transfomation. If for a given timeStep this variable has a value that is different from the value for the previous timeStep, then that counts as a change for the given timeStep. This triggers the creation of a selection time window that starts at the given timeStep.
timeWindowLengthExpression string required Free format expression that is evaluated at the time of a change in the condition variable to determine the length of the time window (in seconds) for that change. For instance "X1 + X2". In the expression reference input variables or coefficients using their id, e.g. "X1 + a" where "X1" is the variableId of a variable and "a" is the id of a coefficient. Variables can be defined in this transformation or at the start of this transformations file. If a variable definition in this transformation has the same id as a variable definition at the start of this transformations file, then the variable definition in this transformation is used. Coefficients can be defined in a coefficientSet.
selectionType selectionValuesAfterChangeWithTimeWindowSelectionEnumStringType required If this is select_inside_time_window, then all inputVariable values that are within at least one time window are copied to the outputVariable and all other inputVariable values are ignored. If this is select_outside_time_window then all inputVariable values that are within at least one time window are ignored and all other inputVariable values are copied to the outputVariable.
One of: select_inside_time_window, select_outside_time_window
outputVariable OutputVariableComplexType required Output variable. Only the selected times and values are written in this outputVariable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
coefficientSet ExpressionCoefficientSetComplexType required · repeats One or more coefficientSets that are valid for different ranges of the defined limit variable. Ranges should not overlap.
coefficientSetFunctions ExpressionCoefficientSetFunctionsComplexType required A coefficientSetFunctions object. This is similar to a coefficientSet object, only the value elements are replaced by function elements. A function is an expression, e.g. "@N@ / 1000", in which tags between "@" signs refer to location attributes that are defined in the locationSets config file. The expression is evaluated after replacing the tags by actual values. These values can be different for different locations and time periods.
coefficientSetId idStringType required Identifier of a coefficientSet to use. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.
coefficientSetFile fileStringType required Name of the file that contains the coefficientSet to use. This name should not include the file extension. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.

AstronomicalNumberSelectedPeakComplexType

Calculates the astronomical number for each selected peak or low

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
selectedPeaksAndLows InputVariableComplexType required Input series with peaks and low
correctionTimeLocationAttribute idStringType optional The calculated astronomical number can be corrected based on the value of the configured location attribute
astronomicalNumber OutputVariableComplexType optional Output time series with the calculated astronomical number
className nameStringType optional

EnsembleMemberByIndexSelectionComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
memberIndex InputVariableComplexType required
ensemble InputVariableComplexType required
outputVariable OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

SelectionGridEnsembleMemberIndexComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputEnsembleIndices InputVariableComplexType required
inputTimeSeriesGrids InputVariableComplexType required
output OutputVariableComplexType required
matchInputAndOutputGridTimes boolean optional The time of the output time series is determined by the time of the ensemble member indices. It can happen that the input grids do not have data at the given time. If matchInputAndOutputGridTimes is set to false, and the exact time step is unavailable, the first available grid data of the given ensemble member will be filled in the output. If it is set to true, output will only be filled if the data is available for the exact time.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

SelectionScalarTimeSeriesFromScalarMapComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
input InputVariableComplexType required
output OutputVariableComplexType required
minDomainValue float required The minimum domain vale to be included in the selection.
maxDomainValue float required The maximum domain vale to be included in the selection.
minValueInclusive boolean optional
maxValueInclusive boolean optional
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

SelectionScalarTimeSeriesLayersFromScalarMapComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
input InputVariableComplexType required
layerIndex int required Layers are counted from the highest Z coordinate (water surface) towards to lowest (water bottom) starting with 1.
output OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

SelectNumberedTidalPeaksComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
numberedTidalPeaks InputVariableComplexType required : non-equidistant input series holding the tidal numbers
continuousLevelSeries InputVariableComplexType required equidistant input series holding the water levels
highWaterLevelOutput OutputVariableComplexType required non-equidistant output series holding the waterlevels at the peak
highWaterTideNumberOutput OutputVariableComplexType required non-equidistant output series holding the associated tidal number of the peak
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
minutesBeforeTidalExtreme int required Search window before tidal extreme in minutes
minutesBeforeTidalExtremeAttributeId idStringType required The id of the location attribute to be used as search window before tidal extreme. Value should be in minutes.
minutesAfterTidalExtreme int required Search window after tidal extreme in minutes
minutesAfterTidalExtremeAttributeId idStringType required The id of the location attribute to be used as search window after tidal extreme. Value should be in minutes.
regressionPeriodInMinutes int required time span used to compute the average rate of waterlevel change. The extreme has been reached when the sign flips for the rate of change
regressionPeriodInMinutesAttributeId idStringType required The id of the location attribute to be used as time span to compute the average rate of waterlevel change. The extreme has been reached when the sign flips for the rate of change
validDifferenceExceedence float required Extreme is valid and selected when specified difference is exceeded by at least one value within the search window both before and after the extreme.
validDifferenceExceedenceAttributeId idStringType required The id of the location attribute to be used as validDifferenceExceedence. Extreme is valid and selected when specified difference is exceeded by at least one value within the search window both before and after the extreme.

SelectNumberedTidalLowsComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
numberedTidalLows InputVariableComplexType required Non-equidistant input series holding the tidal numbers.
continuousLevelSeries InputVariableComplexType required Equidistant input series holding the water levels.
lowWaterLevelOutput OutputVariableComplexType required Non-equidistant output series holding the waterlevels at the low.
lowWaterTideNumberOutput OutputVariableComplexType required Non-equidistant output series holding the associated tidal number of the low.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
minutesBeforeTidalExtreme int required Search window before tidal extreme in minutes
minutesBeforeTidalExtremeAttributeId idStringType required The id of the location attribute to be used as search window before tidal extreme. Value should be in minutes.
minutesAfterTidalExtreme int required Search window after tidal extreme in minutes
minutesAfterTidalExtremeAttributeId idStringType required The id of the location attribute to be used as search window after tidal extreme. Value should be in minutes.
regressionPeriodInMinutes int required time span used to compute the average rate of waterlevel change. The extreme has been reached when the sign flips for the rate of change
regressionPeriodInMinutesAttributeId idStringType required The id of the location attribute to be used as time span to compute the average rate of waterlevel change. The extreme has been reached when the sign flips for the rate of change
validDifferenceExceedence float required Extreme is valid and selected when specified difference is exceeded by at least one value within the search window both before and after the extreme.
validDifferenceExceedenceAttributeId idStringType required The id of the location attribute to be used as validDifferenceExceedence. Extreme is valid and selected when specified difference is exceeded by at least one value within the search window both before and after the extreme.

TopographicProminencePeaksComplexType

Finds the peak values of the input time series based on topographic prominence and writes this to the output time series.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required
minimumPeakValueFunction string optional Optional location dependent minimum peak value function that can containt location attribute ids, e.g. @DEFAULT_VALUE@. If an attribute is missing for a location, then the default value will be 0 for that location. When element is not defined also 0 will be used.
minimumProminenceFunction string required Location dependent minimum prominence function that can contain location attribute ids, e.g. @DEFAULT_VALUE@. If an attribute is missing for a location, then the default value will be 0 for that location. Peaks with prominence lower than the minimum will be filtered out but the highest peak will always remain. For explanation on topographic prominence see https://en.wikipedia.org/wiki/Topographic_prominence
outputVariable OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

EventsDischargeVolumeComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
discharge InputVariableComplexType required Input variable with instanteous discharge flow values (m3/s).
eventSelection eventsDischargeEventsVolumeEventSelectionEnumStringType required Selects either the total volume or the volume of the event with the largest volume.
One of: all_events, largest_volume_event
maxGapDuration TimeSpanComplexType optional If the timespan between consecutive events (input value below the threshold inbetween) is shorter than this value, these events will be dealt with as one event. If not specified, a maxGapDuration of 24 hours is used for this value as default.
threshold float optional Threshold level above which values are considered to be part of an event.
volume OutputVariableComplexType required Output variable with total volume or the volume of the event with the largest volume.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

EventsDischargeMeanVolumeComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
discharge InputVariableComplexType required Input variable with instanteous discharge flow values (m3/s).
maxGapDuration TimeSpanComplexType optional If the timespan between consecutive events (input value below the threshold inbetween) is shorter than this value, these events will be dealt with as one event. If not specified, a maxGapDuration of 24 hours is used for this value as default.
threshold float optional Threshold level above which values are considered to be part of an event.
meanVolume OutputVariableComplexType required Output variable containing the mean volume (m3) per event.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

EventsDurationComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
input InputVariableComplexType required Input variable.
maxGapDuration TimeSpanComplexType optional If the timespan between consecutive events (input value below the threshold inbetween) is shorter than this value, these events will be dealt with as one event. If not specified, a maxGapDuration of 24 hours is used for this value as default.
threshold float optional Threshold level above which values are considered to be part of an event.
outputTimeUnit timeUnitEnumStringType optional Time unit for the output (default day).
One of: second, minute, hour, day, week
output OutputVariableComplexType required Output variable containing the duration of the events, taking into account the maxGapDuration.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

EventsDurationPerEventComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
input InputVariableComplexType required Input variable.
outputTime eventsDurationPerEventOutputTimeEnumStringType required Determines if the length of the event is written to the output timeseries at the beginning of the event or at the end of the event.
One of: startEvent, endEvent
outputUnit eventsDurationPerEventOutputUnitEnumStringType required Time unit for the output values.
One of: numberOfTimeSteps, seconds
maxGapDuration TimeSpanComplexType optional If the timespan between consecutive events (input value above the threshold inbetween) is shorter than this value, these events will be dealt with as one event.
threshold float optional Threshold level above which values are considered to be part of an event.
output OutputVariableComplexType required Output variable containing the duration of the events.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

EventsMaximumComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
input InputVariableComplexType required Input variable.
maxGapDuration TimeSpanComplexType optional If the timespan between consecutive events (input value below the threshold inbetween) is shorter than this value, these events will be dealt with as one event. If not specified, a maxGapDuration of 24 hours is used for this value as default.
threshold float optional Threshold level above which values are considered to be part of an event.
output OutputVariableComplexType required Output variable containing the maximum value.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

EventsNumberOfEventsComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
input InputVariableComplexType required Input variable.
maxGapDuration TimeSpanComplexType optional If the timespan between consecutive events (input value below the threshold inbetween) is shorter than this value, these events will be dealt with as one event. If not specified, a maxGapDuration of 24 hours is used for this value as default.
threshold float optional Threshold level above which values are considered to be part of an event.
output OutputVariableComplexType required Output variable containing the number of events.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

DaySampleComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required input time series
outputVariable OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

DayMonthSampleComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required input time series
outputVariable OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

JulianDaySampleComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required input time series
julianDayVariable InputVariableComplexType required series with Julian Days
outputVariable OutputVariableComplexType required Output variable.
className nameStringType optional The sampling 'instruction' is provided as a series where the value refers to (historical) dates in JulianDay. These Julian Days are used to extract the associated data from the input timeseries and place it in the output timeseries using the corresponding timestamp.

SampleEquidistantComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
equidistantInputVariable InputVariableComplexType required time series which will be transformed to a non-equidistant time series
timeReferenceInputVariable InputVariableComplexType required This variable defines the time steps which will be written to the output time series
forecastLoopSearchPeriod RelativePeriodComplexType optional Period in which forecasts should be searched to loop over
interpolationType sampleEquidistantInterpolationTypeEnumStringType required
One of: closest, closestForward, closestBackward, linear, missing
ignoreMissing boolean optional If true, then missing values are ignored. If false, then an output value will be missing if one or more of the corresponding input values are missing or unreliable. Default is true.
timeWindow TimeSpanComplexType optional This optional variable defines a time window in which the closest times, found in the original series, should lie. This time window is related to the time in the outputseries we search the values for. E.g. for interpolationType 'closest' we search in the period from timeOut-timeWindow to timeOut+timeWindow, where the timeOut is a time in the output series.
outputVariable OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

SampleHistoricalComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
moduleParameterFile nameStringType optional reference to a module parameter file which can be modified in the mods-display
inputVariable InputVariableComplexType required Input variable.
outputVariable OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
moduleParameterFile nameStringType required reference to a module parameter file which can be modified in the mods-display
startYear gYear required Year to start ensemble sampling.
firstEnsembleMemberIndex int optional First ensembleMemberIndex
ensembleMemberCount int optional Number of ensemble members to generate. If this option is not configured, this number will be calculated. The user formula will be T0 - start year = number of ensemble members
startWaterYear monthDayType optional First day of the water year. For example in the USA the water year start at the first of October. The start year is considered a water year when this option is used.

SampleNonEquidistantComplexType

Transform nonEquidistant to equidistant time series.

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
nonEquidistantInputVariable InputVariableComplexType required Input variable.
interpolationType sampleNonEquidistantInterpolationTypeEnumStringType required
One of: block, linear, zero, missing, linearOrClosest, previousTimeStep, nextTimeStep, accumulate, timeWeightedAverage
searchPeriod RelativePeriodComplexType optional Relative period in which the transformation will search for non equidistant values. Only implemented for linear or closest.
maxGapLength TimeSpanComplexType optional Optional maximum length of gap. Gaps equal to or smaller than maxGapLength will be filled with sampled values. Gaps larger than maxGapLength will not be filled. If maxGapLength is not defined, then all gaps will be filled with sampled values. Only implemented for linear and block interpolation
outputVariable OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
ignoreMissing boolean optional If true, then missing values are ignored. If false, then an output value will be missing if one or more of the corresponding input values are missing or unreliable. Default is true.
validationRule ValidationRuleComplexType optional · repeats Since 2013.01. FEWS-8586

NonEquidistantSingleValueComplexType

Transform nonEquidistant to equidistant time series. Each value in the input time series is copied only one time to the output

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required Input variable containing the values which will be copied to the output time series
timeReferenceInputVariable InputVariableComplexType required Input variable containing the times for the output time series
outputVariable OutputVariableComplexType required output variable
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

SampleSingleTimeStepComplexType

Copy the values (grid or scalar) from a source with only 1 time step to all the time steps in the output time series

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required Input variable containing the values which will be copied to the output time series
outputVariable OutputVariableComplexType required output variable
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

MergeInterpolationComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
inputVariable InputVariableComplexType required · repeats One or more input variables to merge.
outputVariable OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
closestDistance MergeInterpolationClosestDistanceComplexType required
interpolationType MergeInterpolationTypeEnumStringType required
One of: bilinear, closestDistance

MergeMeanComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
input InputVariableComplexType required · repeats Input time series with mean data
outputPreviousRun InputVariableComplexType required
missingValuesNotAllowed MergeMeanMissingValuesNotAllowedComplexType optional
output OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

MergeRelationsComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
inputVariableDefinition InputVariableExpressionBasedFunctionComplexType optional · repeats Definitions of variables that can be used as input in one or more relations in this transformation. A variable is always a time series. Alternatively variables can be defined at the start of this transformations file.
relation MergeRelationsRelationComplexType required · repeats One or more relations (expressions). Each relation contains an optional period for which it is valid, a free format expression that is used to determine the output value for the relation and an optional output comment. If for a given time step the first relation produces a missing value, then the next relation is used. If that also produces a missing value, then the next relation is used, and so on, until a non-missing output value is found.
outputVariable OutputVariableComplexType required Output variable for the merged output time series. The output time series contains for each time step the configured output comment of the relation that was used to determine the value for that time step.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
coefficientSet ExpressionCoefficientSetComplexType required · repeats One or more coefficientSets that are valid for different ranges of the defined limit variable. Ranges should not overlap.
coefficientSetFunctions ExpressionCoefficientSetFunctionsComplexType required A coefficientSetFunctions object. This is similar to a coefficientSet object, only the value elements are replaced by function elements. A function is an expression, e.g. "@N@ / 1000", in which tags between "@" signs refer to location attributes that are defined in the locationSets config file. The expression is evaluated after replacing the tags by actual values. These values can be different for different locations and time periods.
coefficientSetId idStringType required Identifier of a coefficientSet to use. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.
coefficientSetFile fileStringType required Name of the file that contains the coefficientSet to use. This name should not include the file extension. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.

MergeSimpleComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
inputVariable MergeSimpleInputVariableComplexType required · repeats One or more input variables to merge.
fillGapConstant float optional Optional constant to fill gaps containing unreliable or missing values that are still present after merge.
outputVariable OutputVariableComplexType required Output variable.
indexUsedInputVariable OutputVariableComplexType optional Output variable which stores the index of the used input time series.
copyCommentWhenMissing boolean optional concatenates and copies comments to output variable only when output value is missing.
keepManualUnreliables boolean optional If true, values that have manualy been set to unreliable are kept. If se to false manual unreliables are seen as missings.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
coefficientSet MergeSimpleCoefficientSetComplexType required · repeats One or more coefficientSets that are valid for different ranges of the defined limit variables. Ranges should not overlap.
moduleParameterFile nameStringType required reference to a module parameter file which can be modified in the mods-display
reverseOrderAttributeId idStringType required Since 2018.02 Define a boolean attribute which can be used to revert the merge order.
coefficientSetId idStringType required Identifier of a coefficientSet to use. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.
coefficientSetFile fileStringType required Name of the file that contains the coefficientSet to use. This name should not include the file extension. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.

MergeOneToManyComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
inputVariable MergeSimpleInputVariableComplexType required One or more input variables to merge.
outputVariable OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

MergeSynopticComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
synopticPrecipitation InputVariableComplexType required · repeats Input variables with synoptic rainfall data. The time interval of data values is defined by the timeStep or by the aggregationPeriod.
precipitationOneHour OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

MergeToggleComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required · repeats One or more input variables to merge.
maxGapLength TimeSpanComplexType required If input time series contains a gap larger than maxGapLength, then it will be replaced (instead of merged) with the next input time series in the hierarchy.
fillGapConstant float optional Optional constant to fill gaps containing unreliable or missing values that are still present after merge or toggle.
indexUsedInputTimeSeries OutputVariableComplexType required Variable to store the index of the input time series that is used for the value in the output time series for each time step. 1 for the first, 2 for the second, etc. Requested in issue FEWS-320.
mergedTimeSeries OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

MergeGapComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariable InputVariableComplexType required · repeats One or more input variables to merge.
minimumGapLength TimeSpanComplexType required If input time series contains a gap larger than minimumGapLength, then it will be replaced (instead of merged) with the next input time series in the hierarchy.
fillGapConstant float optional Optional constant to fill gaps containing unreliable or missing values that are still present after merge or toggle.
indexUsedInputTimeSeries OutputVariableComplexType required Variable to store the index of the input time series that is used for the value in the output time series for each time step. 1 for the first, 2 for the second, etc. Requested in issue FEWS-320.
mergedTimeSeries OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
fillEndGap booleanStringType optional Optional element to allow the filling of gaps at the end of a series. Available since 2026.02.

MergeWeightedComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
inputVariable InputVariableComplexType required · repeats Two input variables to merge.
outputVariable OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
moduleParameterFile nameStringType required reference to a module parameter file which can be modified in the mods-display
coefficientSet MergeWeightedCoefficientSetComplexType required · repeats One or more coefficientSets that are valid for different ranges of the defined limit variables. Ranges should not overlap.
coefficientSetId idStringType required Identifier of a coefficientSet to use. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.
coefficientSetFile fileStringType required Name of the file that contains the coefficientSet to use. This name should not include the file extension. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.

MergeSelectLocationComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
input InputVariableComplexType required · repeats the input
attributeFunctionId idStringType required
output OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

MergeSelectDataSourceComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
input InputVariableComplexType required · repeats the input
attributeFunctionId idStringType required The attributeFunctionId will reference the value of the attribute for the current output location
output OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

MergeCopyComplexType

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
input InputVariableComplexType required · repeats the input
skipProperties boolean optional skip copying the properties in the output - optional, by default properties are copied.
skipFlags boolean optional skip copying the flags in the output - optional, by default flags are copied.
skipFlagsSourceColumns boolean optional skip copying the flag source columns in the output - optional, by default flag source columns are copied.
skipFlagSources boolean optional skip copying the flag sources in the output - optional, by default flag sources are copied.
skipComments boolean optional skip copying the comments in the output - optional, by default comments are copied.
output OutputVariableComplexType required Output variable.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

CriticalConditionalLookupTransformationComplexType

if a default value cannot be found in the rules criteria, an output value is searched in the lookup table

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
inputVariableDefinition InputVariableExpressionBasedFunctionComplexType optional · repeats Definitions of variables that can be used as input in this transformation. A variable is always a time series. Alternatively variables can be defined at the start of this transformations file.
criticalConditionLookup CriticalConditionLookUpComplexType required
defaultValue RuleCriteriasComplexType optional
outputVariable OutputVariableComplexType required
reportAllConditions boolean optional Optional element to disable reporting of all conditions. Default is true. Set to false to disable warnings.
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

AdjustQComplexType

adjusts the simulated discharge values with observed discharge data

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
correctNegativeFlowValuesToZero boolean optional
observedInstantaneousDischarge InputVariableComplexType required
observedMeanDailyDischarge InputVariableComplexType required
simulatedDischarge InputVariableComplexType required
adjustedSimulatedDischarge OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
coefficientSet AdjustQCoefficientSetComplexType required · repeats One or more coefficientSets that are valid for different ranges of the defined limit variables. Ranges should not overlap.
coefficientSetFunctions AdjustQCoefficientSetFunctionsComplexType required Since 2014.01. A coefficientSetFunctions object. This is similar to a coefficientSet object, only the value elements are replaced by function elements. A function is an expression, e.g. "@N@ / 1000", in which tags between "@" signs refer to location attributes that are defined in the locationSets config file. The expression is evaluated after replacing the tags by actual values. These values can be different for different locations and time periods.
moduleParameterFile nameStringType required reference to a module parameter file which can be modified in the mods-display
coefficientSetId idStringType required Identifier of a coefficientSet to use. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.
coefficientSetFile fileStringType required Name of the file that contains the coefficientSet to use. This name should not include the file extension. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.

AdjustQUsingMeanDailyDischargeComplexType

Adjusts the simulated discharge values with a adjustment method which uses mean daily discharge values

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
observedMeanDailyDischarge InputVariableComplexType required
simulatedDischarge InputVariableComplexType required
adjustedSimulatedDischarge OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
coefficientSet AdjustQUsingMeanDailyDischargeCoefficientSetComplexType required · repeats One or more coefficientSets that are valid for different ranges of the defined limit variables. Ranges should not overlap.
coefficientSetFunctions AdjustQUsingMeanDailyDischargeCoefficientSetFunctionsComplexType required Since 2014.01. A coefficientSetFunctions object. This is similar to a coefficientSet object, only the value elements are replaced by function elements. A function is an expression, e.g. "@N@ / 1000", in which tags between "@" signs refer to location attributes that are defined in the locationSets config file. The expression is evaluated after replacing the tags by actual values. These values can be different for different locations and time periods.
coefficientSetId idStringType required Identifier of a coefficientSet to use. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.
coefficientSetFile fileStringType required Name of the file that contains the coefficientSet to use. This name should not include the file extension. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.

AdjustQUsingObservedInstantaneousDischargeComplexType

interpolates the missing values in the observed data with simulated data

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
correctNegativeFlowValuesToZero boolean optional
observedDischarge InputVariableComplexType required
simulatedInstantaneousDischarge InputVariableComplexType required
adjustedForecastDischarge OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
coefficientSet AdjustQUsingInstantaneousDischargeCoefficientSetComplexType required · repeats One or more coefficientSets that are valid for different ranges of the defined limit variables. Ranges should not overlap.
coefficientSetFunctions AdjustQUsingInstantaneousDischargeCoefficientSetFunctionsComplexType required Since 2014.01. A coefficientSetFunctions object. This is similar to a coefficientSet object, only the value elements are replaced by function elements. A function is an expression, e.g. "@N@ / 1000", in which tags between "@" signs refer to location attributes that are defined in the locationSets config file. The expression is evaluated after replacing the tags by actual values. These values can be different for different locations and time periods.
moduleParameterFile nameStringType required reference to a module parameter file which can be modified in the mods-display
coefficientSetId idStringType required Identifier of a coefficientSet to use. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.
coefficientSetFile fileStringType required Name of the file that contains the coefficientSet to use. This name should not include the file extension. CoefficientSets are defined in a transformationCoefficientSets file in the CoefficientSetsFiles directory.

AdjustStageComplexType

Adjusts the computed stage values with the input from stage rev

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
forecastStage InputVariableComplexType required Input variable with the computed stage (water level) values.
averageBalanceFirstSegment InputVariableComplexType required Balance for the first segment. The first segment is segment with the lowest stage ranges
averageBalanceSecondSegment InputVariableComplexType required Balance for the second segment
averageBalanceThirdSegment InputVariableComplexType required Balance for the third segment
averageBalanceFourthSegment InputVariableComplexType required Balance for the fourth segment
startFirstStageRange InputVariableComplexType required start of the first segment
startSecondStageRange InputVariableComplexType required end of the first segment and the start of the second segment
startThirdStageRange InputVariableComplexType required start of the third segment
startFourthStageRange InputVariableComplexType required start of the fourth segment
endFourthStageRange InputVariableComplexType required end of the fourth segment
adjustedForecastStage OutputVariableComplexType required end of the fourth segment
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

AdjustTideComplexType

adjusts the tidal time series by using the output from tideBalanceReview

ElementTypeCardinalityDescription
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.
period TransformationRunPeriodComplexType optional This element can be used to configure the run period of the transformation.
trimOutput trimOutputEnumStringType optional When true missing values at the start and end of the output will be removed before writing the data to the database. This can prevent existing values to be overwritten with missings.
One of: true, false, startOnly, endOnly
limitVariable InputVariableComplexType optional Optional limit variable. For each time step the value of this variable is checked against the limiting ranges defined in coefficientSets to determine which coefficientSet is used for that time step. A limit variable has to be a scalar variable.
observedTidalStage InputVariableComplexType required
forecastTidalStage InputVariableComplexType required
tideBalance InputVariableComplexType required
adjustedTidalStage OutputVariableComplexType required
className nameStringType optional Optional element to define the name of the class that should be executed to perform this transformation. Normally this element can be left out of the xml configuration, and the default class name will be used. This default class name is defined as the default value for this element in the xsd schema for this transformation. Only use this element if you need to use a custom class that is present in the program code.

TransformationRunPeriodComplexType

ElementTypeCardinalityDescription
relativePeriod RelativePeriodComplexType required
cardinalTimeStep TimeStepComplexType required Aligns the start and end time of the run period of the transformation with this time step.
extendStart boolean required Determines whether the start of the run period of the transformation should be extended or cropped to match the cardinal time step
extendEnd boolean required Determines whether the end of the run period of the transformation should be extended or cropped to match the cardinal time step
startMonthDay monthDayType required
endMonthDay monthDayType required

InputVariableComplexType

Choose between a reference to a variable or an embedded definition of a variable.

ElementTypeCardinalityDescription
variableId idStringType required Identifier of a variable to use.
locationId idStringType optional If the specified variable contains multiple locations, then specify the location to use here.
timeSeriesSet TimeSeriesSetComplexType required A time series set that can be used as input or as output for a transformation function.
convertDatum boolean optional If true, then this time series is converted from local to ordnance datum level before a transformation and back to local datum level after the transformation. Default is false.
checkMissing boolean optional Option to check this timeseries for missing values. This option works in combination with the Parameter flag 'allowMissing', which can be set for a parameter in the parameters.xml configuration file. If for a given parameter allowMissing is false and checkMissing is true, then the transformation throws an exception when there are missing values for this parameter. When omitted defaults to 'false'. For grid data this option only checks whether the entire grid contains missing values or not, i.e. individual cells can still have missing values as long as there are other cells with non-missing values in the grid for the same time step.

OutputVariableComplexType

Choose between a reference to a variable or an embedded definition of a variable.

ElementTypeCardinalityDescription
variableId idStringType required Identifier of a variable to use.
locationId idStringType optional If the specified variable contains multiple locations, then specify the location to use here.
timeSeriesSet TimeSeriesSetComplexType required A time series set that can be used as input or as output for a transformation function.
convertDatum boolean optional If true, then this time series is converted from local to ordnance datum level before a transformation and back to local datum level after the transformation. Default is false.
checkMissing boolean optional Option to check this timeseries for missing values. This option works in combination with the Parameter flag 'allowMissing', which can be set for a parameter in the parameters.xml configuration file. If for a given parameter allowMissing is false and checkMissing is true, then the transformation throws an exception when there are missing values for this parameter. When omitted defaults to 'false'. For grid data this option only checks whether the entire grid contains missing values or not, i.e. individual cells can still have missing values as long as there are other cells with non-missing values in the grid for the same time step.

FilterLowPassCoefficientSetComplexType

ElementTypeCardinalityDescription
lowerLimit float optional Optional lower limit above which these coefficients are valid. Lower limit is inclusive. If no lower limit specified, then valid for all values below upper limit.
upperLimit float optional Optional upper limit below which these coefficients are valid. Upper limit is exclusive. If no upper limit specified, then valid for all values above lower limit.
a float required · repeats One or more feedback coefficients (a1 to aN).
b float required · repeats One or more feed forward coefficients (b0 to bM).

FilterLowPassCoefficientSetFunctionsComplexType

ElementTypeCardinalityDescription
a string required · repeats One or more feedback coefficients (a1 to aN).
b string required · repeats One or more feed forward coefficients (b0 to bM).

FilterGaussianCoefficientSetComplexType

ElementTypeCardinalityDescription
lowerLimit float optional Optional lower limit above which these coefficients are valid. Lower limit is inclusive. If no lower limit specified, then valid for all values below upper limit.
upperLimit float optional Optional upper limit below which these coefficients are valid. Upper limit is exclusive. If no upper limit specified, then valid for all values above lower limit.
bandWidth float required

FilterGaussianCoefficientSetFunctionsComplexType

ElementTypeCardinalityDescription
bandWidth string required

DateTimeComplexType

Attributes

AttributeUseNotes
date required
time optional

RelativePeriodComplexType

Defines a moving period in time. The start and end time are relative time to a certain time.

Attributes

AttributeUseNotes
start required
end required
startOverrulable optional default: false. When the running module (e.g. general adaptor) has exported a state the state time is used instead of the specified start time. This option is only available during a (forecast) run.
endOverrulable optional default: false. When a forecast length is specified (e.g. in the manual forecast dialog) the time 0 + forecast length is used instead of the specified end time This option is only available during a (forecast) run.
unit required

Elements

ElementTypeCardinalityDescription
description string optional

PeakCorrectionComplexType

ElementTypeCardinalityDescription
peakNumber int required Peak number since T0, first peak before T0 = -1, second peak before T0 == -2 etc
correctionMultiplicationAttributeId idStringType required Id of location attribute which contains the value of which the difference in peak height must be multiplied with to determine its part of the whole correction value.

OutputPeakCorrectionComplexType

ElementTypeCardinalityDescription
peakNumber int required Peak number since T0, first peak after T0 = 1, second peak after T0 == 2 etc, default is 1

TimeSpanComplexType

Attributes

AttributeUseNotes
unit required
divider optional
multiplier optional

InputVariableExpressionBasedFunctionComplexType

ElementTypeCardinalityDescription
variableId idStringType required Identifier for this variable, as used in the expression.
locationId idStringType required Filter location. If the template variable contains multiple locations, then specify a filter location here.
templateVariableId idStringType required Variable having a time series set definition, which will be used as a template. The variable used in the expression uses the time series set from this template, after filtering for the filter location.
timeSeriesSet TimeSeriesSetComplexType required A time series set that can be used as input or as output for a transformation function.
convertDatum boolean optional If true, then this time series is converted from local to ordnance datum level before a transformation and back to local datum level after the transformation. Default is false.
checkMissing boolean optional Option to check this timeseries for missing values. This option works in combination with the Parameter flag 'allowMissing', which can be set for a parameter in the parameters.xml configuration file. If for a given parameter allowMissing is false and checkMissing is true, then the transformation throws an exception when there are missing values for this parameter. When omitted defaults to 'false'. For grid data this option only checks whether the entire grid contains missing values or not, i.e. individual cells can still have missing values as long as there are other cells with non-missing values in the grid for the same time step.

ExpressionCoefficientSetComplexType

ElementTypeCardinalityDescription
lowerLimit float optional Optional lower limit above which these coefficients are valid. Lower limit is inclusive. If no lower limit specified, then valid for all values below upper limit.
upperLimit float optional Optional upper limit below which these coefficients are valid. Upper limit is exclusive. If no upper limit specified, then valid for all values above lower limit.
coefficient ExpressionCoefficientComplexType required · repeats Coefficients for a free format expression. To use these coefficients, define a free format expression and reference to the identifiers of these coefficients in the expression. Make sure that for all the coefficient identifiers in the free format expression the values are defined here.

ExpressionCoefficientSetFunctionsComplexType

ElementTypeCardinalityDescription
coefficient ExpressionCoefficientFunctionsComplexType required · repeats Coefficients for a free format expression. To use these coefficients, define a free format expression and reference to the identifiers of these coefficients in the expression. Make sure that for all the coefficient identifiers in the free format expression the values are defined here.

ValidationRuleComplexType

ElementTypeCardinalityDescription
minimumInputValuesCount intStringAttributeType optional Only works for non-equidistant data. When there are less than the minimum number of input values available the validation rule is not considered valid.
inputDoubtfulPercentage floatStringAttributeType optional
inputMissingPercentage floatStringAttributeType optional
outputValueFlag validationRuleFlagEnumStringType required
One of: missing, doubtful, reliable
outputCustomFlagSourceId idStringType optional

MergeInterpolationClosestDistanceComplexType

ElementTypeCardinalityDescription
searchRadius doubleStringType optional meters. Default = Infinity.
distanceGeoDatum geoDatumStringType optional Geo datum used to calculate the distances in meters between the points. To calculate distances efficiently and to pre-sort the input points in a grid the earth's curved surface should be transformed to a flat two-dimensional surface. When the input geometry is not in meters calculation of distances will be very slow and a search all is required when there is no exact match. When there is no region/country specific coordinate system available choose a utm zone that best fits with your output region. http://en.wikipedia.org/wiki/File:Utm-zones.jpg. eg. UTM55S for Victoria state in Australia. Only use zone number and N for northern hemisphere and S for southern hemisphere.

MergeMeanMissingValuesNotAllowedComplexType

ElementTypeCardinalityDescription
interpolationType mergeMeanInterpolationTypeEnumStringType required
One of: block, linear
extrapolateDirection interpolationSerialExtrapolateConstantDirectionEnumStringType required If direction is start, then fills only the gap between the start of the input time series and the first data value, with values that are equal to the first data value. If direction is end, then fills only the gap between the last data value and the end of the input time series, with values that are equal to the last data value. If direction is both, then fills both of these gaps.
One of: start, end, both
baseValue float required
recessionConstant recessionConstantSimpleType required

MergeRelationsRelationComplexType

ElementTypeCardinalityDescription
validPeriod PeriodConditionComplexType optional Optional period for which this relation is valid. If a relation is not valid for a given time step, then it is ignored for that time step. If no validPeriod specified, then this relation is always valid. For a period the start time is inclusive and the end time is exclusive.
expression nonEmptyStringType required For instance "X1 + X2". In the expression reference input variables or coefficients using their id, e.g. "X1 + a" where "X1" is the variableId of a variable and "a" is the id of a coefficient. Variables can be defined in this transformation or at the start of this transformations file. If a variable definition in this transformation has the same id as a variable definition at the start of this transformations file, then the variable definition in this transformation is used. Coefficients can be defined in a coefficientSet.
outputFlag mergeRelationOutputFlagEnumStringType optional Optional (optional since stable build 2014.02). If specified the flag specified in this element will be used as the flag for the output.
One of: original, completed, corrected
outputComment nonEmptyStringType optional Optional (optional since stable build 2014.01). If specified, this comment will be put in the output time series for the time steps for which this relation is used to determine the output value.

MergeSimpleInputVariableComplexType

ElementTypeCardinalityDescription
variableId idStringType required Identifier of a variable to use.
locationId idStringType optional If the specified variable contains multiple locations, then specify the location to use here.
timeSeriesSet TimeSeriesSetComplexType required A time series set that can be used as input or as output for a transformation function.
convertDatum boolean optional If true, then this time series is converted from local to ordnance datum level before a transformation and back to local datum level after the transformation. Default is false.
checkMissing boolean optional Option to check this timeseries for missing values. This option works in combination with the Parameter flag 'allowMissing', which can be set for a parameter in the parameters.xml configuration file. If for a given parameter allowMissing is false and checkMissing is true, then the transformation throws an exception when there are missing values for this parameter. When omitted defaults to 'false'. For grid data this option only checks whether the entire grid contains missing values or not, i.e. individual cells can still have missing values as long as there are other cells with non-missing values in the grid for the same time step.
overrulingSourceFlag mergeSimpleOverrulingSourceFlagEnumStringType optional Optional (since stable build 2014.02). If specified the flag specified in this element will be used as the source flag for the output.
One of: original, completed, corrected
overrulingQualityFlag mergeSimpleOverrulingQualityFlagEnumStringType optional Optional (since stable build 2014.02). If specified the flag specified in this element will be used as the quality flag for the output.
One of: reliable, doubtful, unreliable

MergeSimpleCoefficientSetComplexType

ElementTypeCardinalityDescription
lowerLimit float optional Optional lower limit above which these coefficients are valid. Lower limit is inclusive. If no lower limit specified, then valid for all values below upper limit.
upperLimit float optional Optional upper limit below which these coefficients are valid. Upper limit is exclusive. If no upper limit specified, then valid for all values above lower limit.
reverseOrderInputTimeSeries boolean required

MergeWeightedCoefficientSetComplexType

ElementTypeCardinalityDescription
lowerLimit float optional Optional lower limit above which these coefficients are valid. Lower limit is inclusive. If no lower limit specified, then valid for all values below upper limit.
upperLimit float optional Optional upper limit below which these coefficients are valid. Upper limit is exclusive. If no upper limit specified, then valid for all values above lower limit.
weightTime MergeWeightedWeightTimeComplexType required · repeats One or more points in time with weights. Each weight is used for the time for which it is defined. For the times in between, the weights are calculated using linear interpolation. The weight configured for the first point in time is also used for all times before that time. The weight configured for the last point in time is also used for all times after that time.

CriticalConditionLookUpComplexType

Attributes

AttributeUseNotes
id optional

Elements

ElementTypeCardinalityDescription
criticalCondition RuleCriteriasComplexType required · repeats

RuleCriteriasComplexType

Attributes

AttributeUseNotes
rule required rule name or rule result e.g. RED, WARNING, INFO etc.
ruleIndex required rule index is a value which is written to timeseries arrays
rulePreferredColor optional
valuetype optional default: float.
indextype optional default: long.

Elements

ElementTypeCardinalityDescription
ruleCriteria RuleCriteriaComplexType required
ruleCriteriaLogicalOperator logicalOperatorEnumStringType optional
One of: and, or

AdjustQCoefficientSetComplexType

ElementTypeCardinalityDescription
lowerLimit float optional Optional lower limit above which these coefficients are valid. Lower limit is inclusive. If no lower limit specified, then valid for all values below upper limit.
upperLimit float optional Optional upper limit below which these coefficients are valid. Upper limit is exclusive. If no upper limit specified, then valid for all values above lower limit.
blendingSteps positiveInteger required
errorTolerance float required
maxNumberOfIterations positiveInteger required
interpolationType adjustQUsingObservedInstantaneousDischargeInterpolationTypeEnumStringType required
One of: ratio, difference
disableAdjustment boolean optional

AdjustQCoefficientSetFunctionsComplexType

ElementTypeCardinalityDescription
blendingSteps string required
errorTolerance string required
maxNumberOfIterations string required
interpolationType string required
disableAdjustment string optional

AdjustQUsingMeanDailyDischargeCoefficientSetComplexType

ElementTypeCardinalityDescription
lowerLimit float optional Optional lower limit above which these coefficients are valid. Lower limit is inclusive. If no lower limit specified, then valid for all values below upper limit.
upperLimit float optional Optional upper limit below which these coefficients are valid. Upper limit is exclusive. If no upper limit specified, then valid for all values above lower limit.
errorTolerance float required
maxNumberOfIterations positiveInteger required

AdjustQUsingMeanDailyDischargeCoefficientSetFunctionsComplexType

ElementTypeCardinalityDescription
errorTolerance string required
maxNumberOfIterations string required

AdjustQUsingInstantaneousDischargeCoefficientSetComplexType

ElementTypeCardinalityDescription
lowerLimit float optional Optional lower limit above which these coefficients are valid. Lower limit is inclusive. If no lower limit specified, then valid for all values below upper limit.
upperLimit float optional Optional upper limit below which these coefficients are valid. Upper limit is exclusive. If no upper limit specified, then valid for all values above lower limit.
blendingSteps positiveInteger required
interpolationType adjustQUsingObservedInstantaneousDischargeInterpolationTypeEnumStringType required
One of: ratio, difference
disableAdjustment boolean optional

AdjustQUsingInstantaneousDischargeCoefficientSetFunctionsComplexType

ElementTypeCardinalityDescription
blendingSteps string required
interpolationType string required
disableAdjustment string optional

TimeStepComplexType

Time step, There are 5 valid combinations of attributes. id, unit+[multiplier]+[divider]+[timeZone], times+[timeZone] + monthDays+[timeZone] ([]=optional)

Attributes

AttributeUseNotes
id optional Id of the time step. You can reference time steps defined in the regionConfig/timeSteps.xml. Only specify the id attribute when referring to a predefined time step. In the regionConfig/timeSteps.xml the time steps list both the id and the attributes that define the time step
label optional Short name for the time step which is shown to the user when he can choose one from a list.
unit optional
divider optional
multiplier optional
times optional Defines the time step by a list of times without dates, e.g. "10:00 23:00"
minutes optional Since 2017.02. Defines the time step by a list of minutes (with prefix 0 for single digits), e.g. "05 25" which results in times 0:05, 0:25, 1:05, etc.
daysOfMonth optional Defines the time step by a list of days of month, use "01 11 21" for a decade time step
monthDays optional Defines the time step by a list of dates, e.g. ""--03-01 --06-01 --09-01 --12-01" for the meteorological seasons
timeZone optional

Elements

ElementTypeCardinalityDescription
description string optional Optional description of this timeStep. This is not used and is only present for convenience.

TimeSeriesSetComplexType

Attributes

AttributeUseNotes
id optional
name optional

Elements

ElementTypeCardinalityDescription
description string optional
valueType timeSeriesValueTypeStringType required
parameterId idStringType required
domainParameterId idStringType optional · repeats For a spectrum specify the frequency / wave length parameter. For a directional spectrum specify first the frequency parameter and secondly the directional parameter
qualifierId idStringType optional · repeats Id that references an qualifier listed in the regionConfigFiles/Qualifiers.xsd
timeSeriesType timeSeriesTypeStringType required
timeStep TimeStepComplexType required
aggregationPeriod RelativePeriodComplexType optional The value at a time represents the aggregated value over the aggregation period e.g when the aggregation period is -6 to 0 hour the value at 13:00 represents an aggregation (e.g. moving average) from 7:00 till 13:00 (including)
cycle CalendarTimeSpanComplexType optional If cycle specified, then the data is repeated periodically with this cycle as the period length. There is original data for only one cycle. After that cycle the data will be repeated periodically. In other words, when cycle is defined, then a missing value is filled up with a value from the last available cycle before the missing value.
externalForecastSearchTimeStep TimeStepComplexType optional Since 2024.01. Only time series with an external forecast time that match this time step are visible while searching
externalForecastTimeCardinalTimeStep TimeStepComplexType optional When no external forecast exists in the data store younger that the specified age a new external forecast is returned with a minimum age that applies to the specified cardinal time step
qualifierAggregation qualifierAggregationStringType optional When specified all the time series that have ALL the specified qualifiers are aggregated to a single time series on read. Can not be specified when this time series set is meant for writing
readWriteMode timeSeriesReadWriteModeStringType required Note: this readWriteMode is only used in the TimeSeriesDisplay. Other modules ignore this readWriteMode.
synchLevel intStringType optional
expiryTime CalendarTimeSpanComplexType optional
delay TimeShiftComplexType optional
multiplier floatStringType optional
divider floatStringType optional
incrementer floatStringType optional
ensembleId idStringType optional Optional field for running ensembles. Ensemble id's in a time series set will override ensemble id's defined in the workflow.
visibilityControllingFlagSourceColumnId idStringType optional All values that not passed this validation step are removed on read. Set to missing for equidistant and removed for non-equidistant
onlyReliableFlagSourceColumnId idStringType optional Since 2022.02. All values that passed this validation step and are reliable will be included other will be set to missing for equidistant and removed for non-equidistant. This will work as an "or" operation together with "visibilityControllingFlagSourceColumnId", so data should either have passed "visibilityControllingFlagSourceColumnId" or "onlyReliableFlagSourceColumnId".
locationRelationId idStringType required Relation id to map the time series set locations to related locations. Instead of the time series set locations the related locations are used to read/write the time series.
skipLocationsWithoutRelation boolean optional Since 2020.01 When true locations that do not have a related location will be skipped, when false all location must have a related location. Default is false
moduleInstanceId idStringType required · repeats
moduleInstanceSetId idStringType required Query a single module instance in the data store that is available for this time series set
filterModuleInstanceSetId idStringType required Query all module instances in the data store that are available for this time series set
locationId idStringType required · repeats
locationSetId idStringType required
chainageLocationSetId idStringType required Id of location set which represents a chainage of locations. This can only be used in combination with readWriteMode readOnly
relativeViewPeriod TimeSeriesSetRelativePeriodComplexType optional Period relative the time 0 of the workflow or the system time of the fews explorer
relativeForecastPeriod TimeSeriesSetRelativePeriodComplexType optional Period relative to first time of a simulated or external forecast time series
ensembleMemberId nonEmptyStringType required · repeats Optional field used for reading or writing one or more particular ensemble member
ensembleMemberIndex nonNegativeIntegerStringType required Optional field used for reading or writing one particular ensemble member
ensembleMemberIndexRange EnsembleMemberIndexRangeComplexType required Optional field used for reading or writing one particular sub set of the ensemble
relativeForecastSearchPeriod TimeSeriesSetRelativePeriodComplexType required Since 2015.02. The latest available external forecast in this period will be read. By default the latest before time0 is returned
externalForecastTimeId idStringType required Since 2018.01. Forecast time reference id configured in the forecast length estimator config. Can only be used in workflows and only after the forecast length estimator.
externalForecastMinAge TimeSpanComplexType optional Since 2014.02. By default is there is no minimum age. All external forecasts after the time0 are ignored. The age of an external forecast is defined as the time span between the external forecast time and the time 0
externalForecastMaxAge TimeSpanComplexType optional By default is there is no maximum age so the returned external forecast can be very old when there is no recent forecast available. All external forecasts after the time0 are ignored. The age of an external forecast is defined as the time span between the external forecast time and the time 0

ExpressionCoefficientComplexType

Definition of a coefficient.

Attributes

AttributeUseNotes
id required Identifier with which this coefficient is referenced in the free format expression.
value required The float value of this coefficient.

ExpressionCoefficientFunctionsComplexType

Attributes

AttributeUseNotes
id required Identifier with which this coefficient is referenced in the free format expression.
value required Location dependent function for the float value of this coefficient. This can contain location attribute ids, e.g. @COEFFICIENT_A@.

PeriodConditionComplexType

A period condition

ElementTypeCardinalityDescription
validBeforeDateTime DateTimeComplexType required Valid for entire period prior to this date and time.
validAfterDateTime DateTimeComplexType required Valid for entire period after this date and time.
season SeasonConditionComplexType required A seasonal period that is repeated every year.
startDateTime DateTimeComplexType required Start date and time for this period.
endDateTime DateTimeComplexType required End date and time for this period.

MergeWeightedWeightTimeComplexType

ElementTypeCardinalityDescription
relativeTime RelativeTimeComplexType required The relative time for which the corresponding weight is defined. This time is relative to T0.
weight float required Weight for the first inputVariable for the specified time. The weight for the second inputVariable is calculated as follows. Weight for inputVariable2 = 1 - weight for inputVariable1.

RuleCriteriaComplexType

complex type to define rule criteria

ElementTypeCardinalityDescription
rule ConditionComplexType required
ruleGroup ConditionGroupComplexType required

CalendarTimeSpanComplexType

Attributes

AttributeUseNotes
unit required
divider optional
multiplier optional

TimeShiftComplexType

Attributes

AttributeUseNotes
unit required
divider optional
multiplier optional

TimeSeriesSetRelativePeriodComplexType

Defines a moving period in time. The start and end time are relative time to a certain time. When the start time is not specified it is determined by the start time of the state of the current run. When the start is overrulable the time is overruled by the start of search period or the start of cold state run when one of two is specified When the end is overrulable this time is overruled by the end of the forecast when specified

Attributes

AttributeUseNotes
unit required
start optional e.g. -1 hour means one before time 0
end required e.g. 1 hour means one hour after time 0
startOverrulable optional default: false. When the running module (e.g. general adaptor) has exported a state the state time is used instead of the specified start time. This option is only available during a (forecast) run.
endOverrulable optional default: false. When a forecast length is specified (e.g. in the manual forecast dialog) the time 0 + forecast length is used instead of the specified end time This option is only available during a (forecast) run.

Elements

ElementTypeCardinalityDescription
description string optional

EnsembleMemberIndexRangeComplexType

Attributes

AttributeUseNotes
start required
end optional

SeasonConditionComplexType

ElementTypeCardinalityDescription
startMonthDay monthDayType required Start month and day of this season.
endMonthDay monthDayType required End month and day of this season.

RelativeTimeComplexType

Defines a time relative to T0.

Attributes

AttributeUseNotes
value required
unit required

Elements

ElementTypeCardinalityDescription
description string optional Optional description with additional comments. This is never used in the code.

ConditionComplexType

Attributes

AttributeUseNotes
variable required
operator required
value required
logical optional

ConditionGroupComplexType

ElementTypeCardinalityDescription
rule ConditionComplexType required
  • merge simple’s priority order is the inputVariable document order — the first one wins wherever it has data; later ones only fill gaps. reverseOrderInputTimeSeries (in the required coefficientSet) flips that, and reverseOrderAttributeId can flip it per-location from a location attribute. There’s no separate “priority” field to set — reorder the XML.
  • merge simple requires a coefficientSet even with nothing to configure — the schema still requires at least one (with just reverseOrderInputTimeSeries set) even when you don’t need range-dependent behavior. Leaving it out is a config error, not a default-everything shortcut.
  • merge toggle vs. merge gap: both replace the primary series with the next input once a gap exceeds maxGapLength, but toggle stays on the replacement once switched (until it toggles back), while gap only substitutes for the duration of the gap itself. Picking the wrong one either produces an unwanted permanent source-switch or an unwanted reversion mid-event.
  • selection has near-identical *Peaks/*Lows pairs (peaks vs. independentLows, lows vs. independentPeaks, etc.) — the “independent” variants find peaks/lows without requiring a full rise-then-fall cycle between them, which matters for noisy or closely-spaced series. Check the schema annotation for the specific variant before assuming it behaves like the plain one.
  • adjust corrects a computed series against an observed one (e.g. adjust a modeled discharge to match the latest observed gauge reading) — it’s not a general-purpose value editor; it needs both a computed input and a reference observed series configured.