de.fzi.power.interpreter.calculators.energy

Class SimpsonRuleCumulativeEnergyCalculator

java.lang.Object

de.fzi.power.interpreter.calculators.energy.AbstractCumulativeEnergyCalculator

de.fzi.power.interpreter.calculators.energy.SimpsonRuleCumulativeEnergyCalculator

public class SimpsonRuleCumulativeEnergyCalculator
extends AbstractCumulativeEnergyCalculator

This class contains an implementation of Simpson's rule for numerical integration given a series of sampling points and a sampling rate (more precisely, the temporal difference between two consecutive sampling points).
This implementation is tailored to calculating cumulative energy consumption based on power consumption samples. For details about Simpson's rule, cf. calculateNextInternal().

Author:

Florian Rosenthal

See Also:

AbstractCumulativeEnergyCalculator

Constructor Summary

Constructors

Constructor and Description
SimpsonRuleCumulativeEnergyCalculator() Initializes a new instance of the SimpsonRuleCumulativeEnergyCalculator class.
SimpsonRuleCumulativeEnergyCalculator(javax.measure.Measurable<javax.measure.quantity.Duration> samplingPeriod, javax.measure.Measurable<javax.measure.quantity.Duration> initialOffset) Initializes a new instance of the SimpsonRuleCumulativeEnergyCalculator class with given sampling period and initial offset.

Method Summary

Modifier and Type	Method and Description
void	setSamplingPeriod(javax.measure.Measurable<javax.measure.quantity.Duration> samplingPeriod) Sets the sampling period, i.e., the temporal difference between the next consecutive power samples.

Methods inherited from class de.fzi.power.interpreter.calculators.energy.AbstractCumulativeEnergyCalculator

calculateNext, getDefaultResultUnit, getInitialOffset, getResultUnit, getSamplingPeriod, reset, setOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SimpsonRuleCumulativeEnergyCalculator

public SimpsonRuleCumulativeEnergyCalculator()

Initializes a new instance of the SimpsonRuleCumulativeEnergyCalculator class.

SimpsonRuleCumulativeEnergyCalculator

public SimpsonRuleCumulativeEnergyCalculator(javax.measure.Measurable<javax.measure.quantity.Duration> samplingPeriod,
                                             javax.measure.Measurable<javax.measure.quantity.Duration> initialOffset)

Initializes a new instance of the SimpsonRuleCumulativeEnergyCalculator class with given sampling period and initial offset.

Parameters:

samplingPeriod - A Measurable denoting the sampling period, i.e., the temporal difference between two consecutive power samples.

initialOffset - A Measurable denoting the temporal offset of the first power sample, i.e., the point in time it was taken.

Throws:

IllegalArgumentException - An IllegalArgumentException is thrown in one of the following cases:

• samplingPeriod is null or does not represent a positive duration
• initialOffset is null or represents a negative duration

See Also:

SimpsonRuleCumulativeEnergyCalculator(), AbstractCumulativeEnergyCalculator.getDefaultResultUnit(), AbstractCumulativeEnergyCalculator.setOffset(Measurable), setSamplingPeriod(Measurable), AbstractCumulativeEnergyCalculator.getResultUnit()

Method Detail

setSamplingPeriod

public void setSamplingPeriod(javax.measure.Measurable<javax.measure.quantity.Duration> samplingPeriod)

Description copied from class: AbstractCumulativeEnergyCalculator

Sets the sampling period, i.e., the temporal difference between the next consecutive power samples. This might be useful if the sampling points are not equidistant.

Overrides:

setSamplingPeriod in class AbstractCumulativeEnergyCalculator

Parameters:

samplingPeriod - A Measurable denoting the sampling period, i.e., the temporal difference between two consecutive power samples.