SSF.App.Worm
Class MacroscopicModelConfigurator

java.lang.Object
  |
  +--SSF.OS.ProtocolSession
        |
        +--SSF.App.Worm.MacroscopicModelConfigurator

All Implemented Interfaces:

com.renesys.raceway.DML.Configurable

Direct Known Subclasses:

GatewayProtocolSession, WormProtocolSession

public abstract class MacroscopicModelConfigurator

extends ProtocolSession

Common code for configuring options to the macroscopic model.

Nested Class Summary

class

MacroscopicModelConfigurator.MacroModelTimer Timer that drives the global epidemic model.

Field Summary

Fields inherited from class SSF.OS.ProtocolSession

name, use

Constructor Summary

MacroscopicModelConfigurator()

Method Summary

void	configEpidemic(com.renesys.raceway.DML.Configuration cfg) Configure 'Epidemic' keyword for worm epidemic model settings.
void	configGlobalOptions(com.renesys.raceway.DML.Configuration cfg, com.renesys.raceway.DML.Configuration topNetCfg) Configure options for the macroscopic model, epidemic model etc.
float	getSimTime() getSimTime: get the simulation time it's the same function used in tcpSessionMaster.java
void	init_macroscopic() Initalize (after config phase).
void	update() Do one timestep update of the worm model.

Methods inherited from class SSF.OS.ProtocolSession

close, closed, config, debugIdentifier, inGraph, init, open, opened, push, pushAfterDelay, pushAfterDelayFailed, setGraph, version

Methods inherited from class java.lang.Object

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

Constructor Detail

MacroscopicModelConfigurator

public MacroscopicModelConfigurator()

Method Detail

init_macroscopic

public void init_macroscopic()

Initalize (after config phase). First instance creates global epidemic model object and initiates the timer that drives the epidemic model. All instances register with the epidemic model so that it can find them to trigger infection events.

configGlobalOptions

public void configGlobalOptions(com.renesys.raceway.DML.Configuration cfg,
                                com.renesys.raceway.DML.Configuration topNetCfg)

Configure options for the macroscopic model, epidemic model etc. Whenever the WormProtocolSession or GatewayProtocolSession is used, the outermost Net must have a global definition of the worm_model [ ... ] attribute. The worm_model attributes are as follows:

REQUIRED ATTRIBUTES:

• Epidemic --- settings for the worm epidemic. Further described below.

OPTIONAL ATTRIBUTES:

• Traffic --- Invoke worm induced traffic model and supply settings. Further described below.
• delta_t %F --- set the time step size (in seconds).
• stratified_on %S --- stratified model (true or false).
• as_graph %S --- name of AS graph file (connectivity). Required for stratified model.
• debug %S --- "debug true" will switch on debugging printouts for the global epidemic process.

The Epidemic attribute has the following attributes:

REQUIRED ATTRIBUTES:

• s_0 %I -- inital number of suscepible hosts in the whole of the Internet.
• i_0 %I -- inital number of infected hosts
• beta %F -- infection parameter.

OPTIONAL ATTRIBUTES:

• use %S -- specify epidemic model implementation class to use. Default is DeterministicWormEpidemic
• initializer %S -- specify initializer implementation class to use. Default is UniformWormEpidemicInitializer.
• gamma_function %S -- specify removal function implementation class to use. Default is ZeroGammaFunction (no removals).

The Traffic attribute has the following attributes:

REQUIRED ATTRIBUTES:

OPTIONAL ATTRIBUTES:

• use %S -- specify traffic model implementation class to use. Default is MeanRateWormTraffic

configEpidemic

public void configEpidemic(com.renesys.raceway.DML.Configuration cfg)

Configure 'Epidemic' keyword for worm epidemic model settings. See config() method for details.

getSimTime

public float getSimTime()

getSimTime: get the simulation time it's the same function used in tcpSessionMaster.java

update

public void update()

Do one timestep update of the worm model.