genius.core.boaframework

Class BoaParty

java.lang.Object

genius.core.parties.AbstractNegotiationParty

genius.core.boaframework.BoaParty

All Implemented Interfaces:

NegotiationParty, java.io.Serializable

public class BoaParty
extends AbstractNegotiationParty

This class is used to convert a BOA party to a real agent. The parseStrategyParameters loads the information object, the agentSetup uses the information object to load the agent using reflection. This class is special in that it is constructed directly by a BoaPartyRepItem . not for inclusion in a repository or extending. This is converted from BOAagentBilateral and TheBOAagent For more information, see: Baarslag T., Hindriks K.V., Hendrikx M., Dirkzwager A., Jonker C.M. Decoupling Negotiating Agents to Explore the Space of Negotiation Strategies. Proceedings of The Fifth International Workshop on Agent-based Complex Automated Negotiations (ACAN 2012), 2012. https://homepages.cwi.nl/~baarslag/pub/Decoupling_Negotiating_Agents_to_Explore_the_Space_of_Negotiation_Strategies_ACAN_2012.pdf

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected AcceptanceStrategy	acceptConditions Decides when to accept
protected NegotiationSession	negotiationSession Links to the negotiation domain
protected OfferingStrategy	offeringStrategy Decides what to offer
protected OMStrategy	omStrategy Selects which bid to send when using an opponent model
protected OpponentModel	opponentModel Approximates the utility of a bid for the opponent
protected OutcomeSpace	outcomeSpace Contains the space of possible bids
java.util.ArrayList<Pair<Bid,java.lang.String>>	savedOutcomes Store Multi_AcceptanceCondition outcomes

Fields inherited from class genius.core.parties.AbstractNegotiationParty

rand, timeline, userModel, utilitySpace

Constructor Summary

Constructors

Constructor and Description
BoaParty(AcceptanceStrategy ac, java.util.Map<java.lang.String,java.lang.Double> acParams, OfferingStrategy os, java.util.Map<java.lang.String,java.lang.Double> osParams, OpponentModel om, java.util.Map<java.lang.String,java.lang.Double> omParams, OMStrategy oms, java.util.Map<java.lang.String,java.lang.Double> omsParams) Stores all relevant values for initializing the components.

Method Summary

Modifier and Type	Method and Description
Action	chooseAction(java.util.List<java.lang.Class<? extends Action>> possibleActions) When this function is called, it is expected that the Party chooses one of the actions from the possible action list and returns an instance of the chosen action.
void	cleanUp() Clears the agent's variables.
void	endSession(NegotiationResult result) Method that first calls the endSession method of each component to receiveMessage the session data and then stores the session data if it is not empty and is changed.
AcceptanceStrategy	getAcceptanceStrategy() Returns the acceptance strategy of the agent.
java.lang.String	getDescription()
OfferingStrategy	getOfferingStrategy() Returns the offering strategy of the agent.
OpponentModel	getOpponentModel() Returns the opponent model of the agent.
void	init(NegotiationInfo info) Initializes the party, informing it of many negotiation details.
void	receiveMessage(AgentID sender, Action opponentAction) This method is called to inform the party that another NegotiationParty chose an Action.

Methods inherited from class genius.core.parties.AbstractNegotiationParty

estimateUtilitySpace, generateRandomBid, getData, getDeadlines, getDomain, getLastReceivedAction, getNumberOfParties, getPartyId, getProtocol, getRandomValue, getTimeLine, getUserModel, getUtility, getUtilitySpace, getUtilityWithDiscount, isUncertain, negotiationEnded, toString

Methods inherited from class java.lang.Object

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

Field Detail

acceptConditions

protected AcceptanceStrategy acceptConditions

Decides when to accept

offeringStrategy

protected OfferingStrategy offeringStrategy

Decides what to offer

opponentModel

protected OpponentModel opponentModel

Approximates the utility of a bid for the opponent

omStrategy

protected OMStrategy omStrategy

Selects which bid to send when using an opponent model

negotiationSession

protected NegotiationSession negotiationSession

Links to the negotiation domain

savedOutcomes

public java.util.ArrayList<Pair<Bid,java.lang.String>> savedOutcomes

Store Multi_AcceptanceCondition outcomes

outcomeSpace

protected OutcomeSpace outcomeSpace

Contains the space of possible bids

Constructor Detail

BoaParty

public BoaParty(AcceptanceStrategy ac,
                java.util.Map<java.lang.String,java.lang.Double> acParams,
                OfferingStrategy os,
                java.util.Map<java.lang.String,java.lang.Double> osParams,
                OpponentModel om,
                java.util.Map<java.lang.String,java.lang.Double> omParams,
                OMStrategy oms,
                java.util.Map<java.lang.String,java.lang.Double> omsParams)

Stores all relevant values for initializing the components. Will be used when init is called.

Parameters:

ac -

acParams -

os -

osParams -

om -

omParams -

oms -

omsParams -

Method Detail

init

public void init(NegotiationInfo info)

Description copied from interface: NegotiationParty

Initializes the party, informing it of many negotiation details. This MUST be called exactly once, immediately after construction of any class implementing this.

Specified by:

init in interface NegotiationParty

Overrides:

init in class AbstractNegotiationParty

Parameters:

info - information about the negotiation that this party is part of.

receiveMessage

public void receiveMessage(AgentID sender,
                           Action opponentAction)

Description copied from interface: NegotiationParty

This method is called to inform the party that another NegotiationParty chose an Action.

Specified by:

receiveMessage in interface NegotiationParty

Overrides:

receiveMessage in class AbstractNegotiationParty

Parameters:

sender - The initiator of the action.This is either the AgentID, or null if the sender is not an agent (e.g., the protocol).

opponentAction - The action performed

chooseAction

public Action chooseAction(java.util.List<java.lang.Class<? extends Action>> possibleActions)

Description copied from interface: NegotiationParty

When this function is called, it is expected that the Party chooses one of the actions from the possible action list and returns an instance of the chosen action.

Parameters:

possibleActions - List of all actions possible.

Returns:

The chosen Action.

getOfferingStrategy

public OfferingStrategy getOfferingStrategy()

Returns the offering strategy of the agent.

Returns:

offeringstrategy of the agent.

getOpponentModel

public OpponentModel getOpponentModel()

Returns the opponent model of the agent.

Returns:

opponent model of the agent.

getAcceptanceStrategy

public AcceptanceStrategy getAcceptanceStrategy()

Returns the acceptance strategy of the agent.

Returns:

acceptance strategy of the agent.

endSession

public void endSession(NegotiationResult result)

Method that first calls the endSession method of each component to receiveMessage the session data and then stores the session data if it is not empty and is changed.

cleanUp

public void cleanUp()

Clears the agent's variables.

getDescription

public java.lang.String getDescription()

Returns:

a human-readable description for this party.