genius.core.boaframework

Class OMStrategy

java.lang.Object

genius.core.boaframework.BOA

genius.core.boaframework.OMStrategy

public abstract class OMStrategy
extends BOA

This is the abstract class which determines when the opponent model may be updated, and how it used to select a bid for the opponent. Tim Baarslag, Koen Hindriks, Mark Hendrikx, Alex Dirkzwager and Catholijn M. Jonker. Decoupling Negotiating Agents to Explore the Space of Negotiation Strategies

Author:

Mark Hendrikx

Field Summary

Fields

Modifier and Type	Field and Description
protected OpponentModel	model Reference to the opponent model

Fields inherited from class genius.core.boaframework.BOA

negotiationSession

Constructor Summary

Constructors

Constructor and Description
OMStrategy()

Method Summary

Modifier and Type	Method and Description
abstract boolean	canUpdateOM()
abstract BidDetails	getBid(java.util.List<BidDetails> bidsInRange) Returns a bid selected using the opponent model from the given set of similarly preferred bids.
BidDetails	getBid(OutcomeSpace space, Range range) Returns a bid selected using the opponent model with a utility in the given range.
BidDetails	getBid(SortedOutcomeSpace space, double targetUtility) Use this method in case no range is specified, but only a target utility.
void	init(NegotiationSession negotiationSession, OpponentModel model, java.util.Map<java.lang.String,java.lang.Double> parameters) Initialize method to be used by the BOA framework.
java.io.Serializable	loadData() Method used to load the saved object, possibly created in a previous negotiation session.
void	setOpponentModel(OpponentModel model)
void	storeData(java.io.Serializable object) Method used to store data that should be accessible in the next negotiation session on the same scenario.

Methods inherited from class genius.core.boaframework.BOA

endSession, getName, getParameters, getParameterSpec, init

Methods inherited from class java.lang.Object

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

Field Detail

model

protected OpponentModel model

Reference to the opponent model

Constructor Detail

OMStrategy

public OMStrategy()

Method Detail

init

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

Initialize method to be used by the BOA framework.

Parameters:

negotiationSession - state of the negotiation.

model - opponent model to which the opponent model strategy applies.

parameters - for the opponent model strategy, for example the maximum receiveMessage time.

getBid

public abstract BidDetails getBid(java.util.List<BidDetails> bidsInRange)

Returns a bid selected using the opponent model from the given set of similarly preferred bids.

Parameters:

bidsInRange - set of similarly preferred bids

Returns:

bid

getBid

public BidDetails getBid(OutcomeSpace space,
                         Range range)

Returns a bid selected using the opponent model with a utility in the given range.

Parameters:

space - of all possible outcomes

range - of utility

Returns:

bid

setOpponentModel

public void setOpponentModel(OpponentModel model)

getBid

public BidDetails getBid(SortedOutcomeSpace space,
                         double targetUtility)

Use this method in case no range is specified, but only a target utility. This method has two steps: First a set of bids is generated using the following procedure. The method looks at the bids in the range [targetUtility, targetUtility + INITIAL_WINDOW_RANGE]. If there are less than EXPECTED_BIDS_IN_WINDOW in the window, then the upperbound is increased by RANGE_INCREMENT. Second a bid for the opponent is selected by calling getBid(List bidsInRange) with the generated set.

Parameters:

space - of all possible outcomes

targetUtility - minimum utility to

Returns:

bid selected by using the opponent model strategy.

canUpdateOM

public abstract boolean canUpdateOM()

Returns:

if given the negotiation state the opponent model may be updated

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.