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:

 

Transformation StatisticsPeriodic - percentileNoneExceedance
<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>

 

 

displayGroup subplot definition for below example plot
<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>

 

  • No labels

Disclaimer