genius.core.boaframework

Class OpponentModel

java.lang.Object

genius.core.boaframework.BOA

genius.core.boaframework.OpponentModel

Direct Known Subclasses:

NoModel

public abstract class OpponentModel
extends BOA

Describes an opponent model of an agent of the BOA framework. This model assumes issue weights hence only supports AdditiveUtilitySpace. Tim Baarslag, Koen Hindriks, Mark Hendrikx, Alex Dirkzwager and Catholijn M. Jonker. Decoupling Negotiating Agents to Explore the Space of Negotiation Strategies

Author:

Alex Dirkzwager, Mark Hendrikx

Field Summary

Fields

Modifier and Type	Field and Description
protected AdditiveUtilitySpace	opponentUtilitySpace Reference to the estimated opponent's utility state

Fields inherited from class genius.core.boaframework.BOA

negotiationSession

Constructor Summary

Constructors

Constructor and Description
OpponentModel()

Method Summary

Modifier and Type	Method and Description
void	cleanUp() Removes references to the objects used by the opponent model.
double	getBidEvaluation(Bid bid) Determines the utility of a bid according to the preference profile.
double[]	getIssueWeights()
java.lang.String	getName()
AbstractUtilitySpace	getOpponentUtilitySpace()
double	getWeight(Issue issue) Returns the weight of a particular issue in the domain.
void	init(NegotiationSession negotiationSession, java.util.Map<java.lang.String,java.lang.Double> parameters) Initializes the model.
boolean	isCleared()
java.io.Serializable	loadData() Method used to load the saved object, possibly created in a previous negotiation session.
void	setOpponentUtilitySpace(AdditiveUtilitySpace opponentUtilitySpace) Method which may be overwritten by an opponent model to get access to the opponent's utilityspace.
void	setOpponentUtilitySpace(BilateralAtomicNegotiationSession fNegotiation) Method which may be overwritten by an opponent model to get access to the opponent's utilityspace.
void	storeData(java.io.Serializable object) Method used to store data that should be accessible in the next negotiation session on the same scenario.
void	updateModel(Bid opponentBid) Method used to receiveMessage the opponent model.
abstract void	updateModel(Bid bid, double time) Method used to receiveMessage the opponent model.

Methods inherited from class genius.core.boaframework.BOA

endSession, getParameters, getParameterSpec

Methods inherited from class java.lang.Object

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

Field Detail

opponentUtilitySpace

protected AdditiveUtilitySpace opponentUtilitySpace

Reference to the estimated opponent's utility state

Constructor Detail

OpponentModel

public OpponentModel()

Method Detail

init

public void init(NegotiationSession negotiationSession,
                 java.util.Map<java.lang.String,java.lang.Double> parameters)

Initializes the model. The init method should always be called after creating an opponent model.

Overrides:

init in class BOA

Parameters:

negotiationSession - reference to the state of the negotiation

parameters -

Throws:

java.lang.Exception

updateModel

public void updateModel(Bid opponentBid)

Method used to receiveMessage the opponent model.

Parameters:

opponentBid -

updateModel

public abstract void updateModel(Bid bid,
                                 double time)

Method used to receiveMessage the opponent model.

Parameters:

bid - to receiveMessage the model with.

time - at which the bid was offered.

getBidEvaluation

public double getBidEvaluation(Bid bid)

Determines the utility of a bid according to the preference profile.

Parameters:

bid - of which the utility is calculated.

Returns:

Utility of the bid

getOpponentUtilitySpace

public AbstractUtilitySpace getOpponentUtilitySpace()

Returns:

the estimated utility space of the opponent

setOpponentUtilitySpace

public void setOpponentUtilitySpace(BilateralAtomicNegotiationSession fNegotiation)

Method which may be overwritten by an opponent model to get access to the opponent's utilityspace.

Parameters:

fNegotiation -

setOpponentUtilitySpace

public void setOpponentUtilitySpace(AdditiveUtilitySpace opponentUtilitySpace)

Method which may be overwritten by an opponent model to get access to the opponent's utilityspace.

Parameters:

opponentUtilitySpace -

getWeight

public double getWeight(Issue issue)

Returns the weight of a particular issue in the domain. Only works with AdditiveUtilitySpace.

Parameters:

issue - from which the weight should be returned

Returns:

weight of the given issue

getIssueWeights

public double[] getIssueWeights()

Returns:

set of all estimated issue weights.

cleanUp

public void cleanUp()

Removes references to the objects used by the opponent model.

isCleared

public boolean isCleared()

Returns:

if the opponent model is in a usable state.

getName

public java.lang.String getName()

Specified by:

getName in class BOA

Returns:

name of the opponent model.

storeData

public final void storeData(java.io.Serializable object)

Description copied from class: BOA

Method used to store data that should be accessible in the next negotiation session on the same scenario. This method can be called during the negotiation, but it makes more sense to call it in the endSession method.

Specified by:

storeData in class BOA

Parameters:

object - to be saved by this component.

loadData

public final java.io.Serializable loadData()

Description copied from class: BOA

Method used to load the saved object, possibly created in a previous negotiation session. The method returns null when such an object does not exist yet.

Specified by:

loadData in class BOA

Returns:

saved object or null when not available.