genius.core.utility

Class NonlinearUtilitySpace

java.lang.Object

genius.core.utility.AbstractUtilitySpace

genius.core.utility.NonlinearUtilitySpace

All Implemented Interfaces:

UtilitySpace, java.io.Serializable

public class NonlinearUtilitySpace
extends AbstractUtilitySpace

In the non-linear scenarios, the agents no longer have linear utility functions; instead, they can only sample their utility of a bid through the getUtility() method. The utility of an offer can be completely arbitrary, so there is no underlying structure you can use. In terms of the API of Genius, this means the agents no longer have access to methods pertaining to linear scenarios (e.g., getWeight()). Please use the getUtility() method to sample the utilities in the non-linear scenarios to search through the outcome space.

See Also:

Serialized Form

Field Summary

Fields inherited from class genius.core.utility.AbstractUtilitySpace

DISCOUNT_FACTOR, fileName, RESERVATION

Constructor Summary

Constructors

Constructor and Description
NonlinearUtilitySpace() Creates an empty nonlinear utility space.
NonlinearUtilitySpace(Domain domain)
NonlinearUtilitySpace(Domain domain, java.lang.String fileName)
NonlinearUtilitySpace(NonlinearUtilitySpace us) create a clone of another utility space

Method Summary

Modifier and Type	Method and Description
UtilitySpace	copy()
boolean	equals(java.lang.Object obj) Uses the original equals of Object.
double	getUtility(Bid bid)
java.lang.String	isComplete() Check if this utility space is complete and ready for negotiation.
java.lang.String	toString()
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, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NonlinearUtilitySpace

public NonlinearUtilitySpace()

Creates an empty nonlinear utility space.

NonlinearUtilitySpace

public NonlinearUtilitySpace(Domain domain)

NonlinearUtilitySpace

public NonlinearUtilitySpace(Domain domain,
                             java.lang.String fileName)
                      throws java.lang.Exception

Throws:

java.lang.Exception

NonlinearUtilitySpace

public NonlinearUtilitySpace(NonlinearUtilitySpace us)

create a clone of another utility space

Method Detail

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

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).

equals

public boolean equals(java.lang.Object obj)

Uses the original equals of Object.

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

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.