genius.core.utility

Class UtilitySpaceTools

java.lang.Object

genius.core.utility.UtilitySpaceTools

All Implemented Interfaces:

java.io.Serializable

public class UtilitySpaceTools
extends java.lang.Object
implements java.io.Serializable

Companion class to UtilitySpace. Some utility functions that work on a utility space. Works as an add-on on a given UtilitySpace. Does not extend it, so that receivers of an abstract UtilitySpace can connect it with these tools too.

This is a class, not a set of static functions, to allow caching of results (not yet implemented). Serializable so that eg AbstractuUtilitySpace can use this as inner class and store cached results.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
UtilitySpaceTools(UtilitySpace space)

Method Summary

Modifier and Type	Method and Description
void	checkReadyForNegotiation(Domain dom) Check if this utility space is ready for negotiation.
Bid	getMaxUtilityBid() Returns the maximum bid in the utility space.
Bid	getMinUtilityBid() Returns the worst bid in the utility space.

Methods inherited from class java.lang.Object

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

Constructor Detail

UtilitySpaceTools

public UtilitySpaceTools(UtilitySpace space)

Method Detail

getMaxUtilityBid

public final Bid getMaxUtilityBid()

Returns the maximum bid in the utility space. This is only supported for linear utility spaces. Expensive: this does a brute-force search through bidspace.

Returns:

a bid with the maximum utility value attainable in this util space

Throws:

java.lang.IllegalStateException - if there is no bid at all in this util space.

getMinUtilityBid

public Bid getMinUtilityBid()

Returns the worst bid in the utility space. This is only supported for linear utility spaces.

Returns:

a bid with the lowest possible utility

Throws:

java.lang.IllegalStateException - if there is no bid at all in the util space

checkReadyForNegotiation

public void checkReadyForNegotiation(Domain dom)

Check if this utility space is ready for negotiation. To be so, the domain must match the given domain and the space must be complete.

Parameters:

dom - is the domain in which nego is taking place

Throws:

java.lang.IllegalStateException - if there is somethign wrong with this domain