genius.core.analysis

Class MultilateralAnalysis

java.lang.Object

genius.core.analysis.MultilateralAnalysis

public class MultilateralAnalysis
extends java.lang.Object

Start on analysis of the multi party tournament. Code in this class is mainly adapted from the bilateral analysis which is in the other classes of this package (negotiator.analysis)

Author:

David Festen

Field Summary

Fields

Modifier and Type	Field and Description
static int	ENUMERATION_CUTOFF Maximum number of bids to analyse

Constructor Summary

Constructors

Constructor and Description
MultilateralAnalysis(java.util.List<? extends PartyWithUtility> parties, Bid agreedBid, java.lang.Double endTime)

Method Summary

Modifier and Type	Method and Description
Bid	getAgreement()
double	getDistanceToNash()
double	getDistanceToPareto()
BidPoint	getKalaiPoint()
BidPoint	getNashPoint()
java.util.List<BidPoint>	getParetoFrontier() Returns the Pareto frontier.
java.util.List<Bid>	getParetoFrontierBids() Method which returns a list of the Pareto efficient bids.
static java.util.ArrayList<double[][]>	getPartyBidSeries(java.util.ArrayList<java.util.ArrayList<java.lang.Double[]>> partyUtilityHistoryList)
double	getSocialWelfare()
java.util.List<UtilitySpace>	getUtilitySpaces()

Methods inherited from class java.lang.Object

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

Field Detail

ENUMERATION_CUTOFF

public static final int ENUMERATION_CUTOFF

Maximum number of bids to analyse

See Also:

Constant Field Values

Constructor Detail

MultilateralAnalysis

public MultilateralAnalysis(java.util.List<? extends PartyWithUtility> parties,
                            Bid agreedBid,
                            java.lang.Double endTime)

Parameters:

parties -

agreedBid - agreement, or null if there is no agreement.

endTime - the time in range [0,1] at which the negotiation ended where 0 is the start and 1 the deadline time/round. If null, undiscounted utilities will be used.

Method Detail

getPartyBidSeries

public static java.util.ArrayList<double[][]> getPartyBidSeries(java.util.ArrayList<java.util.ArrayList<java.lang.Double[]>> partyUtilityHistoryList)

getUtilitySpaces

public java.util.List<UtilitySpace> getUtilitySpaces()

getParetoFrontier

public java.util.List<BidPoint> getParetoFrontier()

Returns the Pareto frontier. If the Pareto frontier is unknown, then it is computed using an efficient algorithm. If the utility space contains more than 500000 bids, then a suboptimal algorithm is used.

Returns:

The Pareto frontier. The order is ascending utilityA.

getParetoFrontierBids

public java.util.List<Bid> getParetoFrontierBids()

Method which returns a list of the Pareto efficient bids.

Returns:

Pareto-efficient bids.

getSocialWelfare

public double getSocialWelfare()

getDistanceToNash

public double getDistanceToNash()

Returns:

distance of agreement to nash point

getDistanceToPareto

public double getDistanceToPareto()

Returns:

distance of agreement to pareto frontier, or Double.POSITIVE_INFINITY if there is no pareto frontier.

getNashPoint

public BidPoint getNashPoint()

getKalaiPoint

public BidPoint getKalaiPoint()

Returns:

kalai-smorodinsky point, or BidPoint(null, 0,0) if utilspace is empty.

getAgreement

public Bid getAgreement()

Returns:

agreement, or null if there is no agreement