Class EventBasedWeightedTally
java.lang.Object
org.djutils.event.EventProducer
org.djutils.stats.summarizers.event.EventBasedWeightedTally
- All Implemented Interfaces:
Serializable
,EventListener
,org.djutils.event.EventListenerInterface
,org.djutils.event.EventProducerInterface
,BasicTallyInterface
,WeightedTallyInterface
public class EventBasedWeightedTally extends org.djutils.event.EventProducer implements org.djutils.event.EventListenerInterface, WeightedTallyInterface
The EventBasedWeightedTally class defines a time-weighted tally that can be notified with weights and values using the
EventListenerInterface. It also produces events when values are tallied and when the tally is initialized.
Copyright (c) 2002-2020 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See
for project information https://simulation.tudelft.nl. The DSOL
project is distributed under a three-clause BSD-style license, which can be found at
https://simulation.tudelft.nl/dsol/3.0/license.html.
- Author:
- Alexander Verbraeck, Peter Knoppers
- See Also:
- Serialized Form
-
Field Summary
-
Constructor Summary
Constructors Constructor Description EventBasedWeightedTally(String description)
Construct a new WeightedTally with a description. -
Method Summary
Modifier and Type Method Description protected void
fireEvents()
Method that can be overridden to fire own events or additional events when ingesting an observation.String
getDescription()
returns the description of this tally.double
getMax()
Returns the max.double
getMin()
Returns the min.long
getN()
Returns the number of observations.Serializable
getSourceId()
double
getWeightedPopulationStDev()
Retrieve the current weighted standard deviation of the observations.double
getWeightedPopulationVariance()
Retrieve the current weighted variance of the observations.double
getWeightedSampleMean()
Retrieve the current weighted sample mean of all observations since the initialization.double
getWeightedSampleStDev()
Retrieve the current weighted sample standard deviation of the observations.double
getWeightedSampleVariance()
Retrieve the current weighted sample variance of the observations.double
getWeightedSum()
Retrieve the current weighted sum of the values of the observations.double
ingest(double weight, double value)
Process one observed weighted value.void
initialize()
initializes the Tally.void
notify(org.djutils.event.EventInterface event)
String
toString()
Methods inherited from class org.djutils.event.EventProducer
addListener, addListener, addListener, addListener, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, fireTimedEvent, getEventTypesWithListeners, getListenerReferences, hasListeners, numberOfListeners, removeAllListeners, removeAllListeners, removeListener
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.djutils.stats.summarizers.WeightedTallyInterface
getWeightedPopulationMean
-
Constructor Details
-
EventBasedWeightedTally
Construct a new WeightedTally with a description.- Parameters:
description
- String; the description of this WeightedTally
-
-
Method Details
-
getSourceId
- Specified by:
getSourceId
in interfaceorg.djutils.event.EventProducerInterface
- Specified by:
getSourceId
in classorg.djutils.event.EventProducer
-
getDescription
returns the description of this tally.- Specified by:
getDescription
in interfaceBasicTallyInterface
- Returns:
- Sting description
-
getMax
public final double getMax()Returns the max.- Specified by:
getMax
in interfaceBasicTallyInterface
- Returns:
- double
-
getMin
public final double getMin()Returns the min.- Specified by:
getMin
in interfaceBasicTallyInterface
- Returns:
- double
-
getN
public final long getN()Returns the number of observations.- Specified by:
getN
in interfaceBasicTallyInterface
- Returns:
- long n
-
getWeightedSampleMean
public final double getWeightedSampleMean()Retrieve the current weighted sample mean of all observations since the initialization.- Specified by:
getWeightedSampleMean
in interfaceWeightedTallyInterface
- Returns:
- double; the current weighted sample mean
-
getWeightedSampleStDev
public final double getWeightedSampleStDev()Retrieve the current weighted sample standard deviation of the observations.- Specified by:
getWeightedSampleStDev
in interfaceWeightedTallyInterface
- Returns:
- double; the current weighted sample standard deviation
-
getWeightedPopulationStDev
public final double getWeightedPopulationStDev()Retrieve the current weighted standard deviation of the observations.- Specified by:
getWeightedPopulationStDev
in interfaceWeightedTallyInterface
- Returns:
- double; the current weighted standard deviation
-
getWeightedSampleVariance
public final double getWeightedSampleVariance()Retrieve the current weighted sample variance of the observations.- Specified by:
getWeightedSampleVariance
in interfaceWeightedTallyInterface
- Returns:
- double; the current weighted sample variance of the observations
-
getWeightedPopulationVariance
public final double getWeightedPopulationVariance()Retrieve the current weighted variance of the observations.- Specified by:
getWeightedPopulationVariance
in interfaceWeightedTallyInterface
- Returns:
- double; the current weighted variance of the observations
-
getWeightedSum
public final double getWeightedSum()Retrieve the current weighted sum of the values of the observations.- Specified by:
getWeightedSum
in interfaceWeightedTallyInterface
- Returns:
- double; the current weighted sum of the values of the observations
-
initialize
public void initialize()initializes the Tally. This methods sets the max, min, n, sum and variance values to their initial values.- Specified by:
initialize
in interfaceBasicTallyInterface
-
notify
public void notify(org.djutils.event.EventInterface event)- Specified by:
notify
in interfaceorg.djutils.event.EventListenerInterface
-
ingest
public double ingest(double weight, double value)Process one observed weighted value.- Parameters:
weight
- double; the weight of the value to processvalue
- double; the value to process- Returns:
- double; the value
-
fireEvents
protected void fireEvents()Method that can be overridden to fire own events or additional events when ingesting an observation. -
toString
-