Disaggregates data by sampling the input values and copying the value from the closest time step.
Input
- inputVariable
Options
- fillGaps (true|false)
- fillGapTimeSteps (integer)
Output
- outputVariable
Description
This transformation performs a disaggregation on an instantaneous input time series. The output values are copied from the closest time step in the input time series. This transformation is similar to Disaggregation Instantaneous except that no interpolation is used.
The fillGaps option can be specified (default is false) to allow filling of gaps in the input time series during disaggreagation. The fillGapTimeSteps setting allows specification of the max number of input time steps to traverse when looking for the closest non-missing value (default = 1)
This transformation also allows the filling of gaps at the end or beginning of an equidistant input series when the requested output series has a longer period than the input, as shown in the following example input/output table:
| Input | Output |
Date/Time | Value | Value |
01-01-1985 00:00 | 1,0 | 1,00 |
01-01-1985 00:15 |
| 1.00 |
01-01-1985 00:30 |
| 2.00 |
01-01-1985 00:45 |
| 2,00 |
01-01-1985 01:00 | 2,00 | 2,00 |
01-01-1985 01:15 |
| 2,00 |
01-01-1985 01:30 |
| -4.00 |
01-01-1985 01:45 |
| -4.00 |
01-01-1985 02:00 | NaN | -4.00 |
| 01-01-1985 02:15 | -4.00 | |
| 01-01-1985 02:30 | -4:00 | |
| 01-01-1985 02:45 | -4.00 | |
| 01-01-1985 03:00 | -4.0 | -4.00 |
| 01-01-1985 03:15 | -4.00 | |
| 01-01-1985 03:30 | -4.00 | |
| 01-01-1985 03:45 | -4.00 | |
| 01-01-1985 04:00 | -4.00 |
Configuration example:
<transformationModule version="1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.wldelft.nl/fews" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/transformationModule.xsd">
<variable>
<variableId>input</variableId>
<timeSeriesSet>
<moduleInstanceId>DisaggregationClosestTimestepTest</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>H.obs.upstream</parameterId>
<locationId>H-2001</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="hour" />
<relativeViewPeriod unit="hour" start="0" end="3"/>
<readWriteMode>editing visible to all future task runs</readWriteMode>
</timeSeriesSet>
</variable>
<variable>
<variableId>output</variableId>
<timeSeriesSet>
<moduleInstanceId>DisaggregationClosestTimestepTest</moduleInstanceId>
<valueType>scalar</valueType>
<parameterId>H.obs.upstream</parameterId>
<locationId>H-2001</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="minute" multiplier="15"/>
<relativeViewPeriod unit="hour" start="0" end="4"/>
<readWriteMode>editing visible to all future task runs</readWriteMode>
</timeSeriesSet>
</variable>
<transformation id="disaggregation closest timestep">
<disaggregation>
<closestTimestep>
<inputVariable>
<variableId>input</variableId>
</inputVariable>
<fillGaps>true</fillGaps>
<fillGapTimeSteps>1</fillGapTimeSteps>
<outputVariable>
<variableId>output</variableId>
</outputVariable>
</closestTimestep>
</disaggregation>
</transformation>
</transformationModule>
