genius.core.uncertainty.flattening

Class FlattenedUtilitySpace

java.lang.Object

genius.core.utility.AbstractUtilitySpace

genius.core.uncertainty.flattening.FlattenedUtilitySpace

All Implemented Interfaces:

UtilitySpace, java.io.Serializable

public class FlattenedUtilitySpace
extends AbstractUtilitySpace

Μajor Class incorporating multiple preference profiles introducing uncertainty about user preferences created by D.Tsimpoukis, Jan 2018

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected FlatteningStrategy	flatteningStrategy
protected java.util.List<AbstractUtilitySpace>	utilitySpaces All possible utility spaces considered
protected java.util.List<java.lang.Double>	weights The corresponding normalized weights of each utility space

Fields inherited from class genius.core.utility.AbstractUtilitySpace

DISCOUNT_FACTOR, fileName, RESERVATION

Constructor Summary

Constructors

Constructor and Description
FlattenedUtilitySpace(FlattenedUtilitySpace multiPrefUS)
FlattenedUtilitySpace(java.util.List<AbstractUtilitySpace> uspaces, Domain dom)
FlattenedUtilitySpace(java.util.List<AbstractUtilitySpace> uspaces, Domain dom, double[] weights) Automatically normalizes the weights
FlattenedUtilitySpace(java.util.List<AbstractUtilitySpace> uspaces, Domain dom, double[] weights, FlatteningStrategy flatteningStrategy)
FlattenedUtilitySpace(java.util.List<AbstractUtilitySpace> uspaces, Domain dom, double[] weights, java.lang.String flatteningStrategy)
FlattenedUtilitySpace(java.util.List<AbstractUtilitySpace> uspaces, Domain dom, java.lang.String flatteningStrategy)

Method Summary

Modifier and Type	Method and Description
UtilitySpace	copy()
static java.util.List<java.lang.Double>	createUniformWeightsList(int size)
java.util.List<java.util.List<BidDetails>>	getBidsInRangeByUtilitySpace(Range range) Returns a list of the size of the number of utility spaces each element of which is a list of the bids in the range we want
FlatteningStrategy	getFlatteningStrategy()
double	getUtility(Bid bid)
java.util.List<AbstractUtilitySpace>	getUtilitySpaces()
java.util.List<java.lang.Double>	getWeights()
java.lang.String	isComplete() Check if this utility space is complete and ready for negotiation.
void	setFlatteningStrategy(FlatteningStrategy flatteningStrategy)
void	setFlatteningStrategyByName(java.lang.String flatteningStrategy) Method used to flatten the list of utility spaces.
void	setUtilitySpaces(java.util.List<AbstractUtilitySpace> uspaces)
void	setWeights(java.util.List<java.lang.Double> weights)
SimpleElement	toXML() Creates an xml representation (in the form of a SimpleElements) of the utilityspace.

Methods inherited from class genius.core.utility.AbstractUtilitySpace

checkReadyForNegotiation, discount, getDiscountFactor, getDomain, getFileName, getMaxUtilityBid, getMinUtilityBid, getName, getReservationValue, getReservationValueUndiscounted, getReservationValueWithDiscount, getReservationValueWithDiscount, getUtilityWithDiscount, getUtilityWithDiscount, isDiscounted, setDiscount, setReservationValue, validateDiscount

Methods inherited from class java.lang.Object

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

Field Detail

utilitySpaces

protected java.util.List<AbstractUtilitySpace> utilitySpaces

All possible utility spaces considered

weights

protected java.util.List<java.lang.Double> weights

The corresponding normalized weights of each utility space

flatteningStrategy

protected FlatteningStrategy flatteningStrategy

Constructor Detail

FlattenedUtilitySpace

public FlattenedUtilitySpace(java.util.List<AbstractUtilitySpace> uspaces,
                             Domain dom,
                             double[] weights)

Automatically normalizes the weights

Parameters:

uspaces -

dom -

weights -

FlattenedUtilitySpace

public FlattenedUtilitySpace(java.util.List<AbstractUtilitySpace> uspaces,
                             Domain dom)

FlattenedUtilitySpace

public FlattenedUtilitySpace(java.util.List<AbstractUtilitySpace> uspaces,
                             Domain dom,
                             java.lang.String flatteningStrategy)

FlattenedUtilitySpace

public FlattenedUtilitySpace(java.util.List<AbstractUtilitySpace> uspaces,
                             Domain dom,
                             double[] weights,
                             FlatteningStrategy flatteningStrategy)

FlattenedUtilitySpace

public FlattenedUtilitySpace(java.util.List<AbstractUtilitySpace> uspaces,
                             Domain dom,
                             double[] weights,
                             java.lang.String flatteningStrategy)

FlattenedUtilitySpace

public FlattenedUtilitySpace(FlattenedUtilitySpace multiPrefUS)

Method Detail

createUniformWeightsList

public static java.util.List<java.lang.Double> createUniformWeightsList(int size)

setFlatteningStrategyByName

public final void setFlatteningStrategyByName(java.lang.String flatteningStrategy)

Method used to flatten the list of utility spaces. It is used to simulate the creation of a new utility space according to a certain mapping of outcomes to utilities. An example is the Average strategy in which case the utility of a bid is calculated as the average of the bid utility of each one of the utility spaces on the list.

getUtility

public double getUtility(Bid bid)

Parameters:

bid - of which we are interested in its utility.

Returns:

Utility of the given bid. This utility is undiscounted: there is no time dependent devaluation of the utility. See also UtilitySpace.discount(double, double).

getBidsInRangeByUtilitySpace

public java.util.List<java.util.List<BidDetails>> getBidsInRangeByUtilitySpace(Range range)

Returns a list of the size of the number of utility spaces each element of which is a list of the bids in the range we want

copy

public UtilitySpace copy()

Returns:

a deep copy of this utility space.

isComplete

public java.lang.String isComplete()

Description copied from interface: UtilitySpace

Check if this utility space is complete and ready for negotiation.

Returns:

null if util space is complete, else returns String containing explanation why not.

toXML

public SimpleElement toXML()
                    throws java.io.IOException

Description copied from interface: UtilitySpace

Creates an xml representation (in the form of a SimpleElements) of the utilityspace.

Returns:

A representation of this utilityspace or null when there was an error.

Throws:

java.io.IOException

getUtilitySpaces

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

setUtilitySpaces

public void setUtilitySpaces(java.util.List<AbstractUtilitySpace> uspaces)

getWeights

public java.util.List<java.lang.Double> getWeights()

setWeights

public void setWeights(java.util.List<java.lang.Double> weights)

getFlatteningStrategy

public FlatteningStrategy getFlatteningStrategy()

setFlatteningStrategy

public void setFlatteningStrategy(FlatteningStrategy flatteningStrategy)