edu.stanford.multiagent.gamer
Class CournotDuopoly

java.lang.Object
  |
  +--edu.stanford.multiagent.gamer.ParameterizedObject
        |
        +--edu.stanford.multiagent.gamer.Game
              |
              +--edu.stanford.multiagent.gamer.CournotDuopoly

public class CournotDuopoly

extends Game

Return an instance of the Cournot Duopoly using user specified functions for the cost and inverse demand. Allows the cost functions for both players to be parameterized separately. Note that although the Cournot Duopoly could be extended in a somewhat straight forward way to more than two players, this game is not generally studied in economics. Therefore we limit the duopoly to a two player game.

Field Summary

Fields inherited from class edu.stanford.multiagent.gamer.Game

actions, DEFAULT_HIGH, DEFAULT_LOW, intMult, intPayoffs, players, pMaxPayoff, pMinPayoff, pNormalize, symActions

Fields inherited from class edu.stanford.multiagent.gamer.ParameterizedObject

parameters

Constructor Summary

CournotDuopoly()

Method Summary

protected void	checkParameters() Checks if Parameter values are consistent.
void	doGenerate() Generate the inverse demand and cost functions.
protected java.lang.String	getGameHelp() Return help screen information about the given game class.
double	getPayoff(int[] outcome, int player) Return the payoff for the given player in the given outcome.
void	initialize() Initializes using preset parameter values
void	randomizeParameters() Sets values of any unset parameters randomly.
void	setParameters(edu.stanford.multiagent.gamer.ParamParser p, boolean randomize) Set the parameters for the game itself, and parse and set the parameters for the cost and inverse demand functions.

Methods inherited from class edu.stanford.multiagent.gamer.Game

generate, getAutoNormPayoff, getDescription, getHelp, getName, getNormPayoff, getNumActions, getNumActions, getNumPlayers, getOutputPayoff, getOutputPayoff, getPayoff, getRangeHelp, parseActions, parsePlayersActions, parsePlayersSameNumberActions, parseSameNumberActions, setDescription, setName, setNormMinAndMax, setNumActions, setNumActions, setNumPlayers, writeGame

Methods inherited from class edu.stanford.multiagent.gamer.ParameterizedObject

getBooleanParameter, getDoubleParameter, getLongParameter, getParamDescription, getParameter, getParameters, getStringParameter, setParameter, setParameter, setParameters

Methods inherited from class java.lang.Object

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

Constructor Detail

CournotDuopoly

public CournotDuopoly()
               throws java.lang.Exception

Method Detail

setParameters

public void setParameters(edu.stanford.multiagent.gamer.ParamParser p,
                          boolean randomize)
                   throws java.lang.Exception

Set the parameters for the game itself, and parse and set the parameters for the cost and inverse demand functions.

Overrides:

setParameters in class ParameterizedObject

Parameters:

p - the ParamParser containing the parameters and their values

randomize - should be set to true if it is desired that any unset parameters be randomized

Throws:

java.lang.Exception

initialize

public void initialize()
                throws java.lang.Exception

Description copied from class: Game

Initializes using preset parameter values

Overrides:

initialize in class Game

Throws:

java.lang.Exception

checkParameters

protected void checkParameters()
                        throws java.lang.Exception

Description copied from class: ParameterizedObject

Checks if Parameter values are consistent. Must be implemented by every non-abstract subclass of ParameterizedObject.

Specified by:

checkParameters in class ParameterizedObject

Throws:

java.lang.Exception - if anything is wrong with the parameter values

randomizeParameters

public void randomizeParameters()

Description copied from class: ParameterizedObject

Sets values of any unset parameters randomly. Can and should be overridden in subclasses to handle a non-uniform distribution and for constraints on parameters.

Overrides:

randomizeParameters in class ParameterizedObject

getGameHelp

protected java.lang.String getGameHelp()

Description copied from class: Game

Return help screen information about the given game class.

Specified by:

getGameHelp in class Game

getPayoff

public double getPayoff(int[] outcome,
                        int player)

Return the payoff for the given player in the given outcome. If Ci is a cost function for player i and P is the inverse demand function and each player j chooses action yj then the payoff for player i is P(y1+y2)yi - Ci(yi)

Specified by:

getPayoff in class Game

Parameters:

outcome - array of integers representing which actions have been chosen by each player

player - the player whose payoff to return

doGenerate

public void doGenerate()

Generate the inverse demand and cost functions.

Specified by:

doGenerate in class ParameterizedObject