org.spectrumauctions.sats.mechanism.cca

Class NonGenericCCAMechanism<T extends Good>

java.lang.Object

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

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

All Implemented Interfaces:

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

public class NonGenericCCAMechanism<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
NonGenericCCAMechanism(List<Bidder<T>> bidders, NonGenericDemandQueryMIPBuilder<T> nonGenericDemandQueryMIPBuilder)

Method Summary

Modifier and Type	Method and Description
void	addSupplementaryRound(NonGenericSupplementaryRound<T> nonGenericSupplementaryRound)
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.
XORBid<T>	getBidAfterClockPhase(Bidder<T> bidder)
XORBid<T>	getBidAfterSupplementaryRound(Bidder<T> bidder)
Map<Bidder<T>,Integer>	getBidCountAfterClockPhase()
Map<Bidder<T>,Integer>	getBidCountAfterSupplementaryRound()
Collection<XORBid<T>>	getBidsAfterClockPhase()
Collection<XORBid<T>>	getBidsAfterSupplementaryRound()
NonGenericDemandQueryMIPBuilder<T>	getDemandQueryBuilder()
Map<T,BigDecimal>	getFinalPrices()
Map<T,BigDecimal>	getLastPrices()
MechanismResult<T>	getMechanismResult()
int	getSupplyMinusDemand()
Map<Bidder<T>,Integer>	getXORBidsCount()
void	setPriceUpdater(NonGenericPriceUpdater<T> nonGenericPriceUpdater)
void	setStartingPrice(Good 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

NonGenericCCAMechanism

public NonGenericCCAMechanism(List<Bidder<T>> bidders,
                              NonGenericDemandQueryMIPBuilder<T> nonGenericDemandQueryMIPBuilder)

Method Detail

getMechanismResult

public MechanismResult<T> getMechanismResult()

Specified by:

getMechanismResult in interface AuctionMechanism<T extends Good>

Specified by:

getMechanismResult in class CCAMechanism<T extends Good>

setStartingPrice

public void setStartingPrice(Good good,
                             BigDecimal price)

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()

getSupplyMinusDemand

public int getSupplyMinusDemand()

getBidsAfterClockPhase

public Collection<XORBid<T>> getBidsAfterClockPhase()

getBidsAfterSupplementaryRound

public Collection<XORBid<T>> getBidsAfterSupplementaryRound()

getXORBidsCount

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

setPriceUpdater

public void setPriceUpdater(NonGenericPriceUpdater<T> nonGenericPriceUpdater)

addSupplementaryRound

public void addSupplementaryRound(NonGenericSupplementaryRound<T> nonGenericSupplementaryRound)

getBidCountAfterClockPhase

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

getBidCountAfterSupplementaryRound

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

getDemandQueryBuilder

public NonGenericDemandQueryMIPBuilder<T> getDemandQueryBuilder()

getFinalPrices

public Map<T,BigDecimal> getFinalPrices()

getLastPrices

public Map<T,BigDecimal> getLastPrices()

getBidAfterClockPhase

public XORBid<T> getBidAfterClockPhase(Bidder<T> bidder)

getBidAfterSupplementaryRound

public XORBid<T> getBidAfterSupplementaryRound(Bidder<T> bidder)