jmadem
Interface utilityFunctionInt


public interface utilityFunctionInt

Interface for the utility functions invoked by MADeMAgArch agents. The code of every utility function must implement this interface.

IMPORTANT NOTE: All utility function names must start in lowercase due to Jason's misinterpretation of uppercase as variable terms.

Author:
Francisco Grimaldo

Method Summary
 float computeUtility(java.lang.String auctioneer, Allocation alloc, MADeMAgArch agArch)
          Computes the normalized utility value given to an allocation.
 java.lang.String getId()
          Returns the name of the utility function
 

Method Detail

getId

java.lang.String getId()
Returns the name of the utility function

Returns:
name of the utility function

computeUtility

float computeUtility(java.lang.String auctioneer,
                     Allocation alloc,
                     MADeMAgArch agArch)
                     throws utilityFunctionException
Computes the normalized utility value given to an allocation.

Parameters:
auctioneer - agent asking for preference
alloc - allocation being evaluated
agArch - architecture of the MADeM agent
Returns:
the utility value assigned to the allocation. Utility values are between [0, 1]; 0 meaning no preference and 1 meaning the highest preference
Throws:
utilityFunctionException - when any error occurs