edu.cuny.cat.market.accepting
Class EquilibriumBeatingAcceptingPolicy

java.lang.Object
  extended by edu.cuny.cat.market.AuctioneerPolicy
      extended by edu.cuny.cat.market.accepting.ShoutAcceptingPolicy
          extended by edu.cuny.cat.market.accepting.OnlyNewShoutDecidingAcceptingPolicy
              extended by edu.cuny.cat.market.accepting.QuoteBeatingAcceptingPolicy
                  extended by edu.cuny.cat.market.accepting.EquilibriumBeatingAcceptingPolicy
All Implemented Interfaces:
AuctionEventListener, edu.cuny.config.param.Parameterizable, edu.cuny.obj.Resetable

public class EquilibriumBeatingAcceptingPolicy
extends QuoteBeatingAcceptingPolicy

implements the shout-accepting rule under which a shout must be more competitive than an estimated equilibrium.

The equilibrium is estimated through some learning algorithm, e.g. sliding-window-average learning and widrowhoff learning, by training with transaction prices.

Parameters

base.delta
double >= 0 (0 by default)
(an absolute amount to relax the restriction on shouts)
base.learner
name of class, implementing MimicryLearner
(the learning algorithm for estimating the equilibrium price)

Default Base

equilibrium_beating_accepting

Version:
$Revision: 1.13 $
Author:
Jinzhong Niu

Field Summary
protected static IllegalShoutException askException
           
protected static IllegalShoutException bidException
          Reusable exceptions for performance
protected  double delta
          A parameter used to adjust the equilibrium price estimate so as to relax the restriction.
static java.lang.String EST_EQUILIBRIUM_PRICE
           
protected  double expectedHighestAsk
           
protected  double expectedLowestBid
           
protected  edu.cuny.ai.learning.MimicryLearner learner
           
static java.lang.String P_DEF_BASE
           
static java.lang.String P_DELTA
           
static java.lang.String P_LEARNER
           
 
Fields inherited from class edu.cuny.cat.market.accepting.QuoteBeatingAcceptingPolicy
DISCLAIMER
 
Fields inherited from class edu.cuny.cat.market.AuctioneerPolicy
auctioneer
 
Constructor Summary
EquilibriumBeatingAcceptingPolicy()
           
 
Method Summary
protected  void askNotAnImprovementException()
           
protected  void bidNotAnImprovementException()
           
 void check(Shout shout)
          checks whether
 void eventOccurred(AuctionEvent event)
           
 double getDelta()
           
 edu.cuny.ai.learning.MimicryLearner getLearner()
           
 void reset()
          resets the state to be the same as the policy is created and initialized.
 void setDelta(double delta)
           
 void setLearner(edu.cuny.ai.learning.MimicryLearner learner)
           
 void setup(edu.cuny.config.param.ParameterDatabase parameters, edu.cuny.config.param.Parameter base)
           
 java.lang.String toString()
           
 
Methods inherited from class edu.cuny.cat.market.accepting.OnlyNewShoutDecidingAcceptingPolicy
check
 
Methods inherited from class edu.cuny.cat.market.AuctioneerPolicy
getAuctioneer, initialize, setAuctioneer
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

bidException

protected static IllegalShoutException bidException
Reusable exceptions for performance


askException

protected static IllegalShoutException askException

expectedHighestAsk

protected double expectedHighestAsk

expectedLowestBid

protected double expectedLowestBid

delta

protected double delta
A parameter used to adjust the equilibrium price estimate so as to relax the restriction.


P_DELTA

public static final java.lang.String P_DELTA
See Also:
Constant Field Values

learner

protected edu.cuny.ai.learning.MimicryLearner learner

P_LEARNER

public static final java.lang.String P_LEARNER
See Also:
Constant Field Values

P_DEF_BASE

public static final java.lang.String P_DEF_BASE
See Also:
Constant Field Values

EST_EQUILIBRIUM_PRICE

public static final java.lang.String EST_EQUILIBRIUM_PRICE
See Also:
Constant Field Values
Constructor Detail

EquilibriumBeatingAcceptingPolicy

public EquilibriumBeatingAcceptingPolicy()
Method Detail

setup

public void setup(edu.cuny.config.param.ParameterDatabase parameters,
                  edu.cuny.config.param.Parameter base)
Specified by:
setup in interface edu.cuny.config.param.Parameterizable
Overrides:
setup in class AuctioneerPolicy

reset

public void reset()
Description copied from class: AuctioneerPolicy
resets the state to be the same as the policy is created and initialized.

Specified by:
reset in interface edu.cuny.obj.Resetable
Overrides:
reset in class AuctioneerPolicy

check

public void check(Shout shout)
           throws IllegalShoutException
checks whether

shout

can beat the estimated equilibrium.

Overrides:
check in class QuoteBeatingAcceptingPolicy
Parameters:
shout - the shout being checked.
Throws:
IllegalShoutException

bidNotAnImprovementException

protected void bidNotAnImprovementException()
                                     throws IllegalShoutException
Throws:
IllegalShoutException

askNotAnImprovementException

protected void askNotAnImprovementException()
                                     throws IllegalShoutException
Throws:
IllegalShoutException

eventOccurred

public void eventOccurred(AuctionEvent event)
Specified by:
eventOccurred in interface AuctionEventListener
Overrides:
eventOccurred in class AuctioneerPolicy

setDelta

public void setDelta(double delta)

getDelta

public double getDelta()

getLearner

public edu.cuny.ai.learning.MimicryLearner getLearner()

setLearner

public void setLearner(edu.cuny.ai.learning.MimicryLearner learner)

toString

public java.lang.String toString()
Overrides:
toString in class AuctioneerPolicy