antsim.impl
Class ExperimentImpl

java.lang.Object
  |
  +--antsim.impl.ExperimentImpl

All Implemented Interfaces:

Clearable, Experiment

public class ExperimentImpl

extends Object

implements Experiment

This class contains a simple implementatin of the Experiment interface, that can be used to quickly test the behavior of an ant species by repeating the scenario a certain number of times. When evaluated, returns an array of statistics objects; each element of the array contains the statistics related to one repetition.

Version:

$Revision: 1.4 $

Author:

Alberto Montresor

Field Summary

protected Factory	factory Factory object used to read configuration parameters and classes
protected boolean	footprint If true, methods for the analysis of experiment footprint are invoked
static String	PAR_ITERATIONS String name of the parameter used to determine the number of iterations to be executed.
static String	PAR_REPETITIONS String name of the parameter used to determine the number of repetitions to be executed.
static String	PROP_FOOTPRINT String name of the Java property used to determine whether the the analyisis of the footprint is activated.
protected int	repetitions Number of repetions of this experiment.
protected Scenario	scenario Scenario on which evaluate the experiment

Fields inherited from interface antsim.Experiment

NAME

Constructor Summary

ExperimentImpl(Factory factory, String name)
Instantiates a new time experiment.

Method Summary

void	clear() Restores the object to its initial state.
Object	evaluate() Perform the evaluation of the current ant algorithm.

Methods inherited from class java.lang.Object

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

Field Detail

PROP_FOOTPRINT

public static final String PROP_FOOTPRINT

String name of the Java property used to determine whether the the analyisis of the footprint is activated.

See Also:

Constant Field Values

PAR_REPETITIONS

public static final String PAR_REPETITIONS

String name of the parameter used to determine the number of repetitions to be executed.

See Also:

Constant Field Values

PAR_ITERATIONS

public static final String PAR_ITERATIONS

String name of the parameter used to determine the number of iterations to be executed.

See Also:

Constant Field Values

repetitions

protected int repetitions

Number of repetions of this experiment. The experiment is repeated a certain number of times, in order to obtain mean values.

footprint

protected boolean footprint

If true, methods for the analysis of experiment footprint are invoked

factory

protected Factory factory

Factory object used to read configuration parameters and classes

scenario

protected Scenario scenario

Scenario on which evaluate the experiment

Constructor Detail

ExperimentImpl

public ExperimentImpl(Factory factory,
                      String name)

Instantiates a new time experiment. Configuration parameters are read through the specified factory object.

Parameters:

factory - the factory to be used to read configuration arguments and to create other configurable objects

name - the name that is associated to this instance in the configuration file

Method Detail

clear

public void clear()

Restores the object to its initial state.

Specified by:

clear in interface Clearable

evaluate

public Object evaluate()

Perform the evaluation of the current ant algorithm. Returns a Stats array containing the statistics collected during the simulation.

In this implementation, a single Stats object is created and is used to collect statistics for all scenario executions performed by this Experiment.

Specified by:

evaluate in interface Experiment