org.spectrumauctions.sats.mechanism.cca

Class GenericCCAMechanism<G extends GenericDefinition<T>,T extends Good>

java.lang.Object

org.spectrumauctions.sats.mechanism.cca.CCAMechanism<T>

org.spectrumauctions.sats.mechanism.cca.GenericCCAMechanism<G,T>

All Implemented Interfaces:

AuctionMechanism<T>, PaymentDeterminator<T>, WinnerDeterminator<T>

public class GenericCCAMechanism<G extends GenericDefinition<T>,T extends Good>
extends CCAMechanism<T>

Field Summary

Fields inherited from class org.spectrumauctions.sats.mechanism.cca.CCAMechanism

bidders, clockPhaseNumberOfBundles, DEFAULT_STARTING_PRICE, epsilon, fallbackStartingPrice, maxRounds, paymentRule, result, totalRounds

Constructor Summary

Constructors

Constructor and Description
GenericCCAMechanism(List<Bidder<T>> bidders, GenericDemandQueryMIPBuilder<G,T> genericDemandQueryMIPBuilder)

Method Summary

Modifier and Type	Method and Description
void	addSupplementaryRound(GenericSupplementaryRound<G,T> genericSupplementaryRound)
Allocation<T>	calculateAllocationAfterSupplementaryRound()
Allocation<T>	calculateClockPhaseAllocation()
void	calculateSampledStartingPrices(int bidsPerBidder, int numberOfWorldSamples, double fraction, long seed) This method allows to simulate a certain knowledge about the player's values.
GenericBid<G,T>	getBidAfterClockPhase(Bidder<T> bidder)
GenericBid<G,T>	getBidAfterSupplementaryRound(Bidder<T> bidder)
Map<Bidder<T>,Integer>	getBidCountAfterClockPhase()
Map<Bidder<T>,Integer>	getBidCountAfterSupplementaryRound()
Collection<GenericBid<G,T>>	getBidsAfterSupplementaryRound()
GenericDemandQueryMIPBuilder<G,T>	getDemandQueryBuilder()
Map<G,BigDecimal>	getFinalPrices()
Map<G,BigDecimal>	getLastPrices()
MechanismResult<T>	getMechanismResult()
int	getSupplyMinusDemand()
void	setPriceUpdater(GenericPriceUpdater<G,T> genericPriceUpdater)
void	setStartingPrice(G good, BigDecimal price)

Methods inherited from class org.spectrumauctions.sats.mechanism.cca.CCAMechanism

adjustPayoffs, calculateAllocation, calculateSampledStartingPrices, copyOf, getEpsilon, getPayment, getTotalRounds, getWdWithoutBidder, setClockPhaseNumberOfBundles, setEpsilon, setFallbackStartingPrice, setMaxRounds, setPaymentRule

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericCCAMechanism

public GenericCCAMechanism(List<Bidder<T>> bidders,
                           GenericDemandQueryMIPBuilder<G,T> genericDemandQueryMIPBuilder)

Method Detail

setStartingPrice

public void setStartingPrice(G good,
                             BigDecimal price)

getMechanismResult

public MechanismResult<T> getMechanismResult()

Specified by:

getMechanismResult in interface AuctionMechanism<T extends Good>

Specified by:

getMechanismResult in class CCAMechanism<T extends Good>

calculateSampledStartingPrices

public void calculateSampledStartingPrices(int bidsPerBidder,
                                           int numberOfWorldSamples,
                                           double fraction,
                                           long seed)

Description copied from class: CCAMechanism

This method allows to simulate a certain knowledge about the player's values. It can be compared to the auctioneer conducting some research before the auction about the bidder's preferences. That way, the starting prices can be adjusted to speed up the auction without sacrificing efficiency. This is simulated by drawing a number of bids from newly created (but based on the same value distributions) bidders

Specified by:

calculateSampledStartingPrices in class CCAMechanism<T extends Good>

Parameters:

bidsPerBidder - How many bids are collected per bidder in each world

numberOfWorldSamples - How many parallel worlds are created to collect these bids

fraction - The fraction of the estimated value that is turned into the starting price

seed - The seed used for drawing the values

calculateClockPhaseAllocation

public Allocation<T> calculateClockPhaseAllocation()

calculateAllocationAfterSupplementaryRound

public Allocation<T> calculateAllocationAfterSupplementaryRound()

getBidsAfterSupplementaryRound

public Collection<GenericBid<G,T>> getBidsAfterSupplementaryRound()

getSupplyMinusDemand

public int getSupplyMinusDemand()

setPriceUpdater

public void setPriceUpdater(GenericPriceUpdater<G,T> genericPriceUpdater)

addSupplementaryRound

public void addSupplementaryRound(GenericSupplementaryRound<G,T> genericSupplementaryRound)

getBidCountAfterClockPhase

public Map<Bidder<T>,Integer> getBidCountAfterClockPhase()

getBidCountAfterSupplementaryRound

public Map<Bidder<T>,Integer> getBidCountAfterSupplementaryRound()

getDemandQueryBuilder

public GenericDemandQueryMIPBuilder<G,T> getDemandQueryBuilder()

getFinalPrices

public Map<G,BigDecimal> getFinalPrices()

getLastPrices

public Map<G,BigDecimal> getLastPrices()

getBidAfterClockPhase

public GenericBid<G,T> getBidAfterClockPhase(Bidder<T> bidder)

getBidAfterSupplementaryRound

public GenericBid<G,T> getBidAfterSupplementaryRound(Bidder<T> bidder)