net.sourceforge.cilib.games.agent.state.evaluation
Interface StateEvaluator

All Known Implementing Classes:

EndGameStateEvaluator, NeuralStateEvaluator, PierreDellacherieTetrisEvaluator

public interface StateEvaluator

Author:

leo This interface defines the methods required to evaluate a given state for a StateEvaluationAgent. It is used to determine which state to select when making a decision.

Method Summary

double	evaluateState(Game<GameState> state, int decisionPlayerID) Evaluate a given GameState for a given player ID.
DomainRegistry	getEvaluatorDomain() If the evaluator can be optimized then the evaluator data should be in a specific domain, this function should return that domain
void	initializeEvaluator(Type evaluatorData) Some state evaluators can be optimised, and therefore the evaluator should be initialized with evaluator specific data.

Method Detail

evaluateState

double evaluateState(Game<GameState> state,
                     int decisionPlayerID)

Evaluate a given GameState for a given player ID.

Parameters:

state - the Game object that is at a specific state that needs to be evaluated

decisionPlayerID - The player that has to make a decision

Returns:

the rating of the state.

initializeEvaluator

void initializeEvaluator(Type evaluatorData)

Some state evaluators can be optimised, and therefore the evaluator should be initialized with evaluator specific data.

Parameters:

evaluatorData - the data that determines how the evaluator should funciton

getEvaluatorDomain

DomainRegistry getEvaluatorDomain()

If the evaluator can be optimized then the evaluator data should be in a specific domain, this function should return that domain

Returns:

The domain of the evaluator