A statisticsPeriodic transformation will compute the configured statistic function. The outputVariable has to be a timeSeries with a defined cycle period. The input periods for a given output time are acquired by repeating the aggregation period for that output time for every cycle. For a given output time the input times in all input periods are used to calculate a result value. A statisticsPeriodic transformation can e.g. be used in climatology to get e.g. the mean temperature in January over the last 100 years. E.g. input series has a temperature value for each day in 100 years and output has a temperature value for each month in the year (this means 12 values in a time series with a cycle of one year).
The StatisticsPeriodic transformation currently only works for a cycle period of one year and only in combination with an output timeStep of type yearlyTimeStep, monthDays, monthlyTimeStep, daysOfMonth or a SimpleEquidistantTimeStep of one day in length. The input timeStep can be anything.
The available statistic functions are:
- count
- countFlags
- kurtosis
- max
- mean
- median
- min
- percentileExceedence
- percentileNonExceedence
- quartile
- rootMeanSquareError
- rsquared
- skewness
- standardDeviation
- sum
- variance
An configuration example is given in the below code block, including an example of the displayGroup:
<variable> <variableId>Q_uur</variableId> <timeSeriesSet> <moduleInstanceId>Aggregeren_uur</moduleInstanceId> <valueType>scalar</valueType> <parameterId>Q.meting</parameterId> <locationId>0001</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep unit="hour"/> <relativeViewPeriod unit="day" start="-365" end="0" startOverrulable="true" endOverrulable="false"/> <readWriteMode>read only</readWriteMode> </timeSeriesSet> </variable> <variable> <variableId>Q_01</variableId> <timeSeriesSet> <moduleInstanceId>Statistiek_Jaarcyclus</moduleInstanceId> <valueType>scalar</valueType> <parameterId>Q.meting</parameterId> <qualifierId>p01</qualifierId> <locationId>0001</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep id="maand3"/> <cycle unit="year"/> <relativeViewPeriod unit="day" start="-365" end="0" startOverrulable="true" endOverrulable="false"/> <readWriteMode>read only</readWriteMode> </timeSeriesSet> </variable> <transformation id="Q_Cycle_01perc"> <statisticsPeriodic> <percentileNonExceedence> <inputVariable> <variableId>Q_uur</variableId> </inputVariable> <value>1</value> <outputVariable> <variableId>Q_01</variableId> </outputVariable> </percentileNonExceedence> </statisticsPeriodic> </transformation>
<subplot> <area> <color>light cyan</color> <timeSeriesSet> <moduleInstanceId>Statistiek_Jaarcyclus</moduleInstanceId> <valueType>scalar</valueType> <parameterId>Q.meting</parameterId> <qualifierId>p01</qualifierId> <locationId>0001</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep id="maand3"/> <cycle unit="year"/> <readWriteMode>read only</readWriteMode> </timeSeriesSet> <timeSeriesSet> <moduleInstanceId>Statistiek_Jaarcyclus</moduleInstanceId> <valueType>scalar</valueType> <parameterId>Q.meting</parameterId> <qualifierId>p99</qualifierId> <locationId>0001</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep id="maand3"/> <cycle unit="year"/> <readWriteMode>read only</readWriteMode> </timeSeriesSet> </area> <area> <color>light blue</color> <timeSeriesSet> <moduleInstanceId>Statistiek_Jaarcyclus</moduleInstanceId> <valueType>scalar</valueType> <parameterId>Q.meting</parameterId> <qualifierId>p10</qualifierId> <locationId>0001</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep id="maand3"/> <cycle unit="year"/> <readWriteMode>read only</readWriteMode> </timeSeriesSet> <timeSeriesSet> <moduleInstanceId>Statistiek_Jaarcyclus</moduleInstanceId> <valueType>scalar</valueType> <parameterId>Q.meting</parameterId> <qualifierId>p90</qualifierId> <locationId>0001</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep id="maand3"/> <cycle unit="year"/> <readWriteMode>read only</readWriteMode> </timeSeriesSet> </area> <color>black</color> <lineStyle>dashed;thick</lineStyle> <markerStyle>none</markerStyle> <timeSeriesSet> <moduleInstanceId>Statistiek_Jaarcyclus</moduleInstanceId> <valueType>scalar</valueType> <parameterId>Q.meting</parameterId> <qualifierId>p50</qualifierId> <locationId>0001</locationId> <timeSeriesType>external historical</timeSeriesType> <timeStep id="maand3"/> <cycle unit="year"/> <relativeViewPeriod unit="day" start="-365" end="0" startOverrulable="true" endOverrulable="false"/> <readWriteMode>read only</readWriteMode> </timeSeriesSet> <timeSeriesSet> <moduleInstanceId>Corrigeer_TMX</moduleInstanceId> <valueType>scalar</valueType> <parameterId>Q.meting</parameterId> <locationSetId>TMX_TSI_Q.meting_uur</locationSetId> <timeSeriesType>external historical</timeSeriesType> <timeStep unit="hour" multiplier="1"/> <relativeViewPeriod unit="day" start="-30" end="-1"/> <readWriteMode>editing visible to all future task runs</readWriteMode> <synchLevel>5</synchLevel> </timeSeriesSet> </subplot>