ai.libs.jaicore.experiments

Class ExperimentRunner

java.lang.Object

ai.libs.jaicore.experiments.ExperimentRunner

public class ExperimentRunner
extends java.lang.Object

This class is used to run experiments.

Constructor Summary

Constructors

Constructor and Description
ExperimentRunner(IExperimentSetConfig config, IExperimentSetEvaluator conductor, IExperimentDatabaseHandle databaseHandle)

Method Summary

Modifier and Type	Method and Description
boolean	conductExperimentIfNotAlreadyConducted(Experiment exp) Conducts a single experiment
void	randomlyConductExperiments(boolean reload) Conducts an unbound number of randomly chosen experiments from the grid.
void	randomlyConductExperiments(int maxNumberOfExperiments, boolean reload) Conducts a limited number of not yet conducted experiments randomly chosen from the grid.
void	setConditionMemoryLimitCheck(boolean doCheck) This method can be used to toggle the check of the memory limit.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExperimentRunner

public ExperimentRunner(IExperimentSetConfig config,
                        IExperimentSetEvaluator conductor,
                        IExperimentDatabaseHandle databaseHandle)

Method Detail

randomlyConductExperiments

public void randomlyConductExperiments(int maxNumberOfExperiments,
                                       boolean reload)
                                throws ExperimentDBInteractionFailedException,
                                       IllegalExperimentSetupException

Conducts a limited number of not yet conducted experiments randomly chosen from the grid.

Parameters:

maxNumberOfExperiments - Limit for the number of experiments

reload - Whether or not the experiment setup should be reloaded between two experiment runs.

Throws:

ExperimentDBInteractionFailedException

IllegalExperimentSetupException

randomlyConductExperiments

public void randomlyConductExperiments(boolean reload)
                                throws ExperimentDBInteractionFailedException,
                                       IllegalExperimentSetupException

Conducts an unbound number of randomly chosen experiments from the grid.

Parameters:

reload - Whether or not the experiment setup should be reloaded between two experiment runs.

Throws:

IllegalExperimentSetupException

ExperimentDBInteractionFailedException

conductExperimentIfNotAlreadyConducted

public boolean conductExperimentIfNotAlreadyConducted(Experiment exp)
                                               throws ExperimentDBInteractionFailedException

Conducts a single experiment

Parameters:

exp -

Throws:

ExperimentAlreadyExistsInDatabaseException

ExperimentDBInteractionFailedException

Exception. - These are not the exceptions thrown by the experiment itself, because these are logged into the database. Exceptions thrown here are technical exceptions that occur when arranging the experiment

setConditionMemoryLimitCheck

public void setConditionMemoryLimitCheck(boolean doCheck)

This method can be used to toggle the check of the memory limit. If the check is active (default or doCheck == true), the memory actually available in this runtime will be taken as an entry for the memory limit.

Parameters:

doCheck - A flag whether the check shall be performed or not. If doCheck is true, the check will be performed and the actually available memory in this runtime environment will be written to the database. Otherwise, the memory limit specified in the configuration file will be written to the database.