edu.usc.ict.iago.agent

Class AgentUtilsExtension

java.lang.Object

edu.usc.ict.iago.agent.AgentUtilsExtension

class AgentUtilsExtension
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
int	adversaryBATNA
int	adversaryRow
boolean	competitive
double	LIE_THRESHOLD
int	myPresentedBATNA
int	myRow
protected java.util.ArrayList<java.lang.Boolean>	previouslyOffered

Constructor Summary

Constructors

Constructor and Description
AgentUtilsExtension(IAGOCoreVH core) Constructor for the AUE.

Method Summary

Modifier and Type	Method and Description
protected void	addPref(Preference p) Adds the given preference to the list of preferences.
protected int	adversaryValue(Offer o, java.util.ArrayList<java.lang.Integer> ordering) Returns the expected value for this agent's adversary on an offer for a given ordering of preferences.
protected int	adversaryValueMax(Offer o) Returns the maximum possible value for an adversary on an offer for all current orderings of preferences.
protected int	adversaryValueMin(Offer o) Returns the minimum possible value for an adversary on an offer for all current orderings of preferences.
protected void	configureGame(GameSpec game) Configures initial parameters for the given game.
boolean	conflictBATNA(int agentBATNA, int adversaryBATNA) determines if a pair of given BATNA's are in conflict, i.e.
protected Preference	dequeuePref() Removes the 0th element in the preferences queue.
protected int	findAdversaryIdealBest() Finds the adversary's highest ranked item in the most ideal ordering
protected int	findAdversaryIdealSecondBest() Finds the adversary's second highest ranked item in the most ideal ordering
protected int	findAdversaryIdealWorst(GameSpec game) Finds the adversary's lowest ranked item in the most ideal ordering
(package private) int	findAdversaryItemIndex(GameSpec game, int num) Finds the position on the board (1 through num issues) of an item with a particular ranking for the agent's adversary.
(package private) java.lang.String	findMyItem(int order, GameSpec game) Finds the name of an item that's ranked a certain way by the agent.
(package private) int	findMyItemIndex(GameSpec game, int num) Finds the position on the board (1 through num issues) of an item with a particular ranking for current agent
protected int	getAdversaryValue(Offer o) Helper to easily return expected/predicted value of an offer for an agent's adversary
int	getID() Getter for the agent's ID (0 for user, 1 for computer agent)
protected int	getLedger() Returns a simple int representing the internal "ledger" of favors done for the agent.
int	getLyingBATNA(GameSpec game, double lieThreshold, boolean liar) Finds the BATNA of an agent, takes into consideration whether it's lying or not
int	getMaxPossiblePoints() Finds the maximum amount of total points to be had in a certain game (i.e., agent's score if they received every item).
protected java.util.ArrayList<java.lang.Integer>	getMinimaxOrdering() Finds the ordering among possible orderings that is most/least different than the VH's ordering, based on the value of isFixedPie (set by separate method).
protected java.util.ArrayList<java.lang.Integer>	getMyOrdering() Returns the normalized ordering of VH preferences (e.g., a point value of {3, 7, 2} would return {2, 1, 3}), with 1 being the highest
protected GameSpec	getSpec() returns the GameSpec being used in the current game.
protected int	getTotalLedger() Returns a simple int representing the internal "ledger" of favors done for the agent, including all pending values.
protected int	getVerbalLedger() Returns a simple int representing the potential "ledger" of favors verbally agreed to.
protected boolean	isFullOffer(Offer o) Check to see if the offer is a full offer.
protected boolean	isImportantGame() Determines if there is a "particularly" valuable item this time around.
protected Event	lastEvent(java.util.LinkedList<Event> history, Event.EventClass type) Returns the last event of type type, or null if nothing found.
protected Event	lastEventReceived(java.util.LinkedList<Event> history, Event.EventClass type) Returns the last event of type type that was received, or null if nothing found.
int	lowerBATNA(int vhPresentedBATNA) determines if a pair of given BATNA's are in conflict, i.e.
protected void	modifyOfferLedger(int increment) Allows you to modify the agent's internal "ledger" of favors done for it.
protected void	modifyVerbalLedger(int increment) Allows you to modify the agent's internal "ledger" of favors done for it.
protected int	myActualOfferValue(Offer o) Returns the value of an offer with respect to the caller.
protected int	myActualOrderValue(java.util.ArrayList<java.lang.Integer> o) Returns the VH value of an ordering (of preferences?).
(package private) Preference	randomPref() Finds a random, accurate preference
protected boolean	reconcileContradictions() Eliminates invalid orderings by looking at preferences, the oldest ones first.
protected Event	secondLastEvent(java.util.LinkedList<Event> history, Event.EventClass type) Returns the second to last event of type type, or null if nothing found.
protected void	setAgentBelief(boolean fixedpie) Sets the agent belief for when multiple opponent orderings are equally likely.

Methods inherited from class java.lang.Object

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

Field Detail

adversaryBATNA

public int adversaryBATNA

myPresentedBATNA

public int myPresentedBATNA

LIE_THRESHOLD

public final double LIE_THRESHOLD

See Also:

Constant Field Values

previouslyOffered

protected java.util.ArrayList<java.lang.Boolean> previouslyOffered

competitive

public boolean competitive

myRow

public int myRow

adversaryRow

public int adversaryRow

Constructor Detail

AgentUtilsExtension

AgentUtilsExtension(IAGOCoreVH core)

Constructor for the AUE.

Parameters:

core - The VH associated with this instance of AUE.

Method Detail

configureGame

protected void configureGame(GameSpec game)

Configures initial parameters for the given game.

Parameters:

game - the game being played.

setAgentBelief

protected void setAgentBelief(boolean fixedpie)

Sets the agent belief for when multiple opponent orderings are equally likely. When true, it assumes it has the same preferences. When false, it does not.

Parameters:

fixedpie - true if fixed pie belief is in effect, false otherwise (if method is not called, defaults to false)

getSpec

protected GameSpec getSpec()

returns the GameSpec being used in the current game.

Returns:

the GameSpec currently being played.

addPref

protected void addPref(Preference p)

Adds the given preference to the list of preferences.

Parameters:

p - the preference to add

dequeuePref

protected Preference dequeuePref()

Removes the 0th element in the preferences queue.

Returns:

the preference removed, or throws IndexOutOfBoundException

myActualOfferValue

protected int myActualOfferValue(Offer o)

Returns the value of an offer with respect to the caller.

Parameters:

o - the offer

Returns:

the total value (how many points the agent will get)

myActualOrderValue

protected int myActualOrderValue(java.util.ArrayList<java.lang.Integer> o)

Returns the VH value of an ordering (of preferences?).

Parameters:

o - the ordering

Returns:

the total value

isFullOffer

protected boolean isFullOffer(Offer o)

Check to see if the offer is a full offer.

Parameters:

o - the offer

Returns:

is full offer

getMyOrdering

protected java.util.ArrayList<java.lang.Integer> getMyOrdering()

Returns the normalized ordering of VH preferences (e.g., a point value of {3, 7, 2} would return {2, 1, 3}), with 1 being the highest

Returns:

an ArrayList of preferences

adversaryValue

protected int adversaryValue(Offer o,
                             java.util.ArrayList<java.lang.Integer> ordering)

Returns the expected value for this agent's adversary on an offer for a given ordering of preferences.

Parameters:

o - the offer

ordering - the ordering

Returns:

the total value

adversaryValueMax

protected int adversaryValueMax(Offer o)

Returns the maximum possible value for an adversary on an offer for all current orderings of preferences.

Parameters:

o - the offer

Returns:

the total value

adversaryValueMin

protected int adversaryValueMin(Offer o)

Returns the minimum possible value for an adversary on an offer for all current orderings of preferences.

Parameters:

o - the offer

Returns:

the total value

findAdversaryIdealBest

protected int findAdversaryIdealBest()

Finds the adversary's highest ranked item in the most ideal ordering

Returns:

index of the best item (for opposing agent)

findAdversaryIdealSecondBest

protected int findAdversaryIdealSecondBest()

Finds the adversary's second highest ranked item in the most ideal ordering

Returns:

index of the second best item (for opposing agent)

findAdversaryIdealWorst

protected int findAdversaryIdealWorst(GameSpec game)

Finds the adversary's lowest ranked item in the most ideal ordering

Returns:

index of the worst item (for opposing agent)

lastEvent

protected Event lastEvent(java.util.LinkedList<Event> history,
                          Event.EventClass type)

Returns the last event of type type, or null if nothing found.

Parameters:

history - the history to search

type - the type of EventClass to search for

Returns:

the event found, or null

lastEventReceived

protected Event lastEventReceived(java.util.LinkedList<Event> history,
                                  Event.EventClass type)

Returns the last event of type type that was received, or null if nothing found.

Parameters:

history - the history to search

type - the type of EventClass to search for

Returns:

the event found, or null

secondLastEvent

protected Event secondLastEvent(java.util.LinkedList<Event> history,
                                Event.EventClass type)

Returns the second to last event of type type, or null if nothing found.

Parameters:

history - the history to search

type - the type of EventClass to search for

Returns:

the event found, or null

reconcileContradictions

protected boolean reconcileContradictions()

Eliminates invalid orderings by looking at preferences, the oldest ones first.

Returns:

true if there are no valid orderings, false otherwise

getLyingBATNA

public int getLyingBATNA(GameSpec game,
                         double lieThreshold,
                         boolean liar)

Finds the BATNA of an agent, takes into consideration whether it's lying or not

Parameters:

game -

lieThreshold - the gauge of how much an agent exaggerates its BATNA

liar - whether or not the agent actually wants to lie

Returns:

the agent's BATNA, either true or a lie.

getMinimaxOrdering

protected java.util.ArrayList<java.lang.Integer> getMinimaxOrdering()

Finds the ordering among possible orderings that is most/least different than the VH's ordering, based on the value of isFixedPie (set by separate method).

Returns:

the chosen ordering.

getMaxPossiblePoints

public int getMaxPossiblePoints()

Finds the maximum amount of total points to be had in a certain game (i.e., agent's score if they received every item).

Returns:

max possible points

conflictBATNA

public boolean conflictBATNA(int agentBATNA,
                             int adversaryBATNA)

determines if a pair of given BATNA's are in conflict, i.e. an offer doesn't exist to satisfy both BATNAs.

Parameters:

agentBATNA - can be either the true BATNA, or the presented BATNA, depending on the circumstances

adversaryBATNA - this should always be the stored value of the opponent's BATNA.

Returns:

true if there is a conflict, false otherwise.

lowerBATNA

public int lowerBATNA(int vhPresentedBATNA)

determines if a pair of given BATNA's are in conflict, i.e. an offer doesn't exist to satisfy both BATNAs. If the BATNAs conflict, it returns a decreased value for the passed in BATNA.

Parameters:

vhPresentedBATNA - can be either the true BATNA, or the presented BATNA, depending on the circumstances

Returns:

an updated BATNA for the VH, possibly lower, if the opponent and VH BATNAs conflict. Always at least the actual VH BATNA.

getAdversaryValue

protected int getAdversaryValue(Offer o)

Helper to easily return expected/predicted value of an offer for an agent's adversary

Parameters:

o - an offer to look at

Returns:

the predicted value of the offer to the adversary.

getID

public int getID()

Getter for the agent's ID (0 for user, 1 for computer agent)

Returns:

current agent's ID

findMyItemIndex

int findMyItemIndex(GameSpec game,
                    int num)

Finds the position on the board (1 through num issues) of an item with a particular ranking for current agent

Parameters:

game -

num - the ranking of the item within an ordering (i.e., 1 means best, 2 means second best, etc.)

Returns:

the index of the item

findAdversaryItemIndex

int findAdversaryItemIndex(GameSpec game,
                           int num)

Finds the position on the board (1 through num issues) of an item with a particular ranking for the agent's adversary.

Parameters:

game -

num - the ranking of the item within an ordering (i.e., 1 means best, 2 means second best, etc.)

Returns:

the index of the item

findMyItem

java.lang.String findMyItem(int order,
                            GameSpec game)

Finds the name of an item that's ranked a certain way by the agent.

Parameters:

order - The rank of the item.

game - The GameSpec being used.

Returns:

the name of the item the agent ranks according to the given order.

randomPref

Preference randomPref()

Finds a random, accurate preference

Returns:

random preference

isImportantGame

protected boolean isImportantGame()

Determines if there is a "particularly" valuable item this time around.

Returns:

a yes or no answer to that question

getLedger

protected int getLedger()

Returns a simple int representing the internal "ledger" of favors done for the agent. Can be negative. Persists across games.

Returns:

the ledger

getTotalLedger

protected int getTotalLedger()

Returns a simple int representing the internal "ledger" of favors done for the agent, including all pending values. Can be negative. Does not persist across games.

Returns:

the ledger

getVerbalLedger

protected int getVerbalLedger()

Returns a simple int representing the potential "ledger" of favors verbally agreed to. Can be negative. Does not persist across games.

Returns:

the ledger

modifyVerbalLedger

protected void modifyVerbalLedger(int increment)

Allows you to modify the agent's internal "ledger" of favors done for it.

Parameters:

increment - value (negative ok)

modifyOfferLedger

protected void modifyOfferLedger(int increment)

Allows you to modify the agent's internal "ledger" of favors done for it.

Parameters:

increment - value (negative ok)