ikr.simlib.entities.generators

Class StdGenerator

java.lang.Object

ikr.simlib.entities.Entity

ikr.simlib.entities.generators.Generator

ikr.simlib.entities.generators.StdGenerator

All Implemented Interfaces:

ReflectionConstructable, ReflectionConstructable2<SimNode,Parameters>

public class StdGenerator
extends Generator

StdGenerator generates messages according to a renewal point process for which IAT distribution is provided/parsed. If a distribution for the length of a message is provided/parsed it sets the message length in an iid fashion. That is, each time a message is created, the message length is drawn according to the given distribution. A MessageFactory may be provided to create messages other than Message.

If a length distribution is provided, the length of the default Message generated by the MessageFactory is overwritten.

StdGenerator is a very flexible Generator with the following characteristics:

• Messages are generated according to the interarrival time distribution.
• Message length follows an optional discrete distribution. Each time a new message is generated by a MessageFactory, the length is adapted by calling setLength() of the message and passing the new length according to the length distribution.
• If no length distribution is provided, the length of the generated message is not changed. Therefore control of the length remains at the MessageFactory.
• A message factory is required and could either be provided by passing it upon generation of StdGenerator or during the parsing procedure.
• All possible combinations of message factories and distributions are described in the source code.

Nested Class Summary

Nested classes/interfaces inherited from class ikr.simlib.entities.Entity

Entity.PortAlias

Field Summary

Fields

Modifier and Type	Field and Description
protected ContinuousDistribution	interArrivalTime
protected DiscreteDistribution	messageLengthDist

Fields inherited from class ikr.simlib.entities.generators.Generator

activated, event, messageFactory, outputPort

Fields inherited from class ikr.simlib.entities.Entity

portAliases, ports, simNode

Fields inherited from interface ikr.simlib.parameters.reflection.ReflectionConstructable

CREATE_INSTANCE_METHOD_NAME

Constructor Summary

Constructors

Modifier	Constructor and Description
	StdGenerator(ContinuousDistribution iat, DiscreteDistribution lengthdist, SimNode ownNode)
	StdGenerator(ContinuousDistribution iat, DiscreteDistribution lengthdist, SimNode ownNode, boolean activateOnStart)
	StdGenerator(ContinuousDistribution iat, DiscreteDistribution lengthdist, SimNode ownNode, Factory<Message> factory)
	StdGenerator(ContinuousDistribution iat, DiscreteDistribution lengthdist, SimNode ownNode, Factory<Message> factory, boolean activateOnStart) Constructor with factory but without parsing.
	StdGenerator(ContinuousDistribution iat, SimNode ownNode)
	StdGenerator(ContinuousDistribution iat, SimNode ownNode, boolean activateOnStart)
	StdGenerator(ContinuousDistribution iat, SimNode ownNode, Factory<Message> factory)
	StdGenerator(ContinuousDistribution iat, SimNode ownNode, Factory<Message> factory, boolean activateOnStart) Constructor without parsing of distributions (w and w/o factory)
protected	StdGenerator(SimNode ownNode)
protected	StdGenerator(SimNode ownNode, boolean activateOnStart)
protected	StdGenerator(SimNode ownNode, Factory<Message> factory)
protected	StdGenerator(SimNode ownNode, Factory<Message> factory, boolean activateOnStart) to be used for subclasses parsing

Method Summary

Methods

Modifier and Type	Method and Description
static StdGenerator	createInstance(SimNode ownNode, Parameters pars) as required by ReflectionConstructable
protected Message	createMessage()
protected double	getNextEventTime(double currentTime)

Methods inherited from class ikr.simlib.entities.generators.Generator

activate, deactivate, getMessageFactory, getOutput, setActivated, setMessageFactory

Methods inherited from class ikr.simlib.entities.Entity

addPort, aliasPort, aliasPort, connect, disconnect, getName, getNode, getPortByName, getPorts, isPortKnown, unaliasPort

Methods inherited from class java.lang.Object

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

Field Detail

interArrivalTime

protected ContinuousDistribution interArrivalTime

messageLengthDist

protected DiscreteDistribution messageLengthDist

Constructor Detail

StdGenerator

protected StdGenerator(SimNode ownNode,
            Factory<Message> factory,
            boolean activateOnStart)

to be used for subclasses parsing

StdGenerator

protected StdGenerator(SimNode ownNode,
            Factory<Message> factory)

StdGenerator

protected StdGenerator(SimNode ownNode,
            boolean activateOnStart)

StdGenerator

protected StdGenerator(SimNode ownNode)

StdGenerator

public StdGenerator(ContinuousDistribution iat,
            DiscreteDistribution lengthdist,
            SimNode ownNode,
            Factory<Message> factory,
            boolean activateOnStart)

Constructor with factory but without parsing. Distributions are required, factory is optional.

StdGenerator

public StdGenerator(ContinuousDistribution iat,
            DiscreteDistribution lengthdist,
            SimNode ownNode,
            Factory<Message> factory)

StdGenerator

public StdGenerator(ContinuousDistribution iat,
            DiscreteDistribution lengthdist,
            SimNode ownNode,
            boolean activateOnStart)

StdGenerator

public StdGenerator(ContinuousDistribution iat,
            DiscreteDistribution lengthdist,
            SimNode ownNode)

StdGenerator

public StdGenerator(ContinuousDistribution iat,
            SimNode ownNode,
            Factory<Message> factory,
            boolean activateOnStart)

Constructor without parsing of distributions (w and w/o factory)

StdGenerator

public StdGenerator(ContinuousDistribution iat,
            SimNode ownNode,
            Factory<Message> factory)

StdGenerator

public StdGenerator(ContinuousDistribution iat,
            SimNode ownNode,
            boolean activateOnStart)

StdGenerator

public StdGenerator(ContinuousDistribution iat,
            SimNode ownNode)

Method Detail

createInstance

public static StdGenerator createInstance(SimNode ownNode,
                          Parameters pars)

as required by ReflectionConstructable

createMessage

protected Message createMessage()

Overrides:

createMessage in class Generator

getNextEventTime

protected double getNextEventTime(double currentTime)

Specified by:

getNextEventTime in class Generator