org.licas.ai_solver.mediator.problem

Class CentralProblemMediator

java.lang.Object

org.licas.service.spec.ServiceSpec

org.licas.ai_solver.mediator.problem.ProblemMediator

org.licas.ai_solver.mediator.problem.CentralProblemMediator

All Implemented Interfaces:

CentralMediatorDef, ProblemMediatorDef

Direct Known Subclasses:

CentralIterateMediator, KnnProblemMediator, SomProblemMediator

public abstract class CentralProblemMediator
extends ProblemMediator
implements CentralMediatorDef

This is the abstract base class for modelling a solver that recieves data from one or more services and processes it locally. This is typically a centralised algorithm.

Author:

Kieran Greer

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.HashMap	dataHash List of data elements
protected java.util.ArrayList	serviceNames List of service names
protected java.util.ArrayList	solutionHierarc Hierarchical / structural list of iterated solutions

Fields inherited from class org.licas.ai_solver.mediator.problem.ProblemMediator

bestResult, fullTrace, problem, result, solutionsList, solutionsNumber, solutionsOrder, solverType, testEnded

Fields inherited from class org.licas.service.spec.ServiceSpec

constructorParams, createServices, dataConditions, datasetType, dirPath, externalScript, heuristicOptions, heuristicType, inputVariables, linkSpec, metricType, serverSpec, serviceClasses, serviceJarFiles, servicesNum, serviceType, tokenizer

Constructor Summary

Constructors

Constructor and Description
CentralProblemMediator(org.licas.PasswordHandler thePasswordHandler) Create a new instance of CentralProblemMediator.

Method Summary

Methods

Modifier and Type	Method and Description
Solution	createNewSolution(java.lang.String solutionType, org.ai_heuristic.eval.metric.MetricDataset problemDataset) Create a new solution by evolving existing ones.
protected void	createStoreData(TestSpec testSpec) Create a new set of problem datasets.
void	firstSolutionsAndProblems(TestSpec testSpec) Generate a number of initial problem solutions based on the test spec.
protected java.util.ArrayList	getProblemsList(TestSpec testSpec) Retrieve or generate the problems list from data files or services.
protected java.util.ArrayList	readData(java.lang.String filePath, java.lang.String separator) Read a data file of values suitable for the entropy grid.
void	resetValues() Reset to starting values

Methods inherited from class org.licas.ai_solver.mediator.problem.ProblemMediator

addHeuristicOption, clearHeuristicOptions, copyToConfig, getFullTrace, getHeuristicOptions, getHeuristicType, getProblem, getSolutionsList, getSolutionsNumber, getTestEnded, processResult, resetForNextRun, setDatasetType, setFullTrace, setHeuristicOptions, setHeuristicType, setProblem, setSolutionsList, setSolutionsNumber

Methods inherited from class org.licas.service.spec.ServiceSpec

getDatasetType, getDirFolder, getTokenizer, parseProblemDataset, setDirFolder, setToknizer, validateScript, validateVariable

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.licas.ai_solver.def.ProblemMediatorDef

getResultXml, solve

Field Detail

serviceNames

protected java.util.ArrayList serviceNames

List of service names

solutionHierarc

protected java.util.ArrayList solutionHierarc

Hierarchical / structural list of iterated solutions

dataHash

protected java.util.HashMap dataHash

List of data elements

Constructor Detail

CentralProblemMediator

public CentralProblemMediator(org.licas.PasswordHandler thePasswordHandler)

Create a new instance of CentralProblemMediator.

Parameters:

thePasswordHandler - for storing passwords.

Method Detail

resetValues

public void resetValues()

Reset to starting values

Overrides:

resetValues in class ProblemMediator

createStoreData

protected void createStoreData(TestSpec testSpec)
                        throws java.lang.Exception

Create a new set of problem datasets. Can be read from a file or retrieved from the distributed services. Single file assumes a single service with a file path content for a dataset to load. Also assumes CSV ','-style separator in the file.

Parameters:

testSpec - the model of the tests to perform.

Throws:

java.lang.Exception - any error.

readData

protected java.util.ArrayList readData(java.lang.String filePath,
                           java.lang.String separator)
                                throws java.lang.Exception

Read a data file of values suitable for the entropy grid.

Parameters:

filePath - the path to a local file. Values only, separated by commas.

separator - the tokenizer character.

Returns:

the file parsed into data rows of string-based values.

Throws:

java.lang.Exception - any error.

getProblemsList

protected java.util.ArrayList getProblemsList(TestSpec testSpec)
                                       throws java.lang.Exception

Retrieve or generate the problems list from data files or services.

Parameters:

testSpec - the test specification.

Returns:

the list of problems.

Throws:

java.lang.Exception - any error.

firstSolutionsAndProblems

public void firstSolutionsAndProblems(TestSpec testSpec)
                               throws java.lang.Exception

Generate a number of initial problem solutions based on the test spec. Typically, the solution name, solution type and a list of problem datasets to initialise each solution with are supplied as parameters in the test spec.

Parameters:

testSpec - the test specification.

Throws:

java.lang.Exception - any error.

createNewSolution

public Solution createNewSolution(java.lang.String solutionType,
                         org.ai_heuristic.eval.metric.MetricDataset problemDataset)
                           throws java.lang.Exception

Create a new solution by evolving existing ones. This is not often used with centralised solvers and this default implementation throws an exception.

Specified by:

createNewSolution in interface CentralMediatorDef

Parameters:

solutionType - the type of solution to create.

problemDataset - the problem dataset to create the solution with.

Returns:

the new solution.

Throws:

java.lang.Exception - any error.