Package microsim.statistics.functions

Class MovingAverageTraceFunction

java.lang.Object

microsim.statistics.functions.AbstractFunction

microsim.statistics.functions.MovingAverageTraceFunction

All Implemented Interfaces:

EventListener, IDoubleSource, IUpdatableSource

public class MovingAverageTraceFunction
extends AbstractFunction
implements IDoubleSource

This class computes the average of the last values collected from a data source. The number of values used to compute the average value is specified in the constructor. The mean function return always double values, so it implements only the IDoubleSource interface.

Title: JAS

Description: Java Agent-based Simulation library

Copyright (C) 2002 Michele Sonnessa

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

Author:

Michele Sonnessa, Ross Richardson

Nested Class Summary

Nested classes/interfaces inherited from interface microsim.statistics.IDoubleSource

IDoubleSource.Variables

Field Summary

Fields

Modifier and Type	Field	Description
protected double	average
protected IDoubleSource	dblSource
protected IFloatSource	fltSource
protected IIntSource	intSource
protected int	len
protected ILongSource	lngSource
protected int	type
protected static final int	TYPE_DBL
protected static final int	TYPE_FLT
protected static final int	TYPE_INT
protected static final int	TYPE_LNG
protected int	valueCount
protected Enum<?>	valueID
protected double[]	values

Fields inherited from class microsim.statistics.functions.AbstractFunction

timeChecker

Constructor Summary

Constructors

Constructor	Description
MovingAverageTraceFunction(IDoubleSource source, Enum<?> valueID, int windowSize)	Create a basic statistic probe on a IDoubleSource object.
MovingAverageTraceFunction(IFloatSource source, Enum<?> valueID, int windowSize)	Create a basic statistic probe on a IFloatSource object.
MovingAverageTraceFunction(IIntSource source, Enum<?> valueID, int windowSize)	Create a basic statistic probe on a IIntSource object.
MovingAverageTraceFunction(ILongSource source, Enum<?> valueID, int windowSize)	Create a basic statistic probe on a ILongSource object.

Method Summary

Modifier and Type	Method	Description
void	applyFunction()	Collect a value from the source.
double	getDoubleValue(Enum<?> valueID)	Return the result of a given statistic.
void	onEvent(Enum<?> type)	ISimEventListener callback function.

Methods inherited from class microsim.statistics.functions.AbstractFunction

isCheckingTime, setCheckingTime, updateSource

Methods inherited from class java.lang.Object

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

Field Details

TYPE_DBL

protected static final int TYPE_DBL

See Also:

• Constant Field Values

TYPE_FLT

protected static final int TYPE_FLT

See Also:

• Constant Field Values

TYPE_INT

protected static final int TYPE_INT

See Also:

• Constant Field Values

TYPE_LNG

protected static final int TYPE_LNG

See Also:

• Constant Field Values

dblSource

protected IDoubleSource dblSource

fltSource

protected IFloatSource fltSource

intSource

protected IIntSource intSource

lngSource

protected ILongSource lngSource

type

protected int type

valueID

protected Enum<?> valueID

len

protected int len

values

protected double[] values

average

protected double average

valueCount

protected int valueCount

Constructor Details

MovingAverageTraceFunction

public MovingAverageTraceFunction(IDoubleSource source,
 Enum<?> valueID,
 int windowSize)

Create a basic statistic probe on a IDoubleSource object.

Parameters:

source - The IDoubleSource object.

valueID - The value identifier defined by source object.

MovingAverageTraceFunction

public MovingAverageTraceFunction(IFloatSource source,
 Enum<?> valueID,
 int windowSize)

Create a basic statistic probe on a IFloatSource object.

Parameters:

source - The IFloatSource object.

valueID - The value identifier defined by source object.

MovingAverageTraceFunction

public MovingAverageTraceFunction(ILongSource source,
 Enum<?> valueID,
 int windowSize)

Create a basic statistic probe on a ILongSource object.

Parameters:

source - The ILongSource object.

valueID - The value identifier defined by source object.

MovingAverageTraceFunction

public MovingAverageTraceFunction(IIntSource source,
 Enum<?> valueID,
 int windowSize)

Create a basic statistic probe on a IIntSource object.

Parameters:

source - The IIntSource object.

valueID - The value identifier defined by source object.

Method Details

applyFunction

public void applyFunction()

Collect a value from the source.

Specified by:

applyFunction in class AbstractFunction

getDoubleValue

public double getDoubleValue(Enum<?> valueID)

Return the result of a given statistic.

Specified by:

getDoubleValue in interface IDoubleSource

Parameters:

valueID - One of the F_ constants representing available statistics.

Returns:

The computed value.

Throws:

UnsupportedOperationException - If the given valueID is not supported.

onEvent

public void onEvent(Enum<?> type)

ISimEventListener callback function. It supports only jas.engine.Sim.EVENT_UPDATE event.

Specified by:

onEvent in interface EventListener

Overrides:

onEvent in class AbstractFunction

Throws:

UnsupportedOperationException - If actionType is not supported.