Package org.spectrumauctions.sats.core.model.mrvm

Class MRVMRegionalBidder

java.lang.Object

org.spectrumauctions.sats.core.model.SATSBidder

org.spectrumauctions.sats.core.model.mrvm.MRVMBidder

org.spectrumauctions.sats.core.model.mrvm.MRVMRegionalBidder

All Implemented Interfaces:

java.io.Serializable, org.marketdesignresearch.mechlib.core.bidder.Bidder, org.marketdesignresearch.mechlib.instrumentation.MipInstrumentationable

public final class MRVMRegionalBidder
extends MRVMBidder

Author:

Michael Weiss

See Also:

Serialized Form

Field Summary

Fields inherited from class org.spectrumauctions.sats.core.model.SATSBidder

DEFAULT_DEMAND_QUERY_EPSILON, DEFAULT_DEMAND_QUERY_TIME_LIMIT

Method Summary

Modifier and Type	Method	Description
protected void	bidderTypeSpecificDemandQueryMIPAdjustments(MRVM_MIP mip)	Allows a specific bidder type (subclass) to change the demand query mip before execution.
MRVMRegionalBidder	drawSimilarBidder(RNGSupplier rngSupplier)
boolean	equals(java.lang.Object obj)
java.math.BigDecimal	gammaFactor(MRVMRegionsMap.Region r, java.util.Set<MRVMLicense> bundle)	Calculates the gamma factor, as explained in the model writeup.
java.util.Map<MRVMRegionsMap.Region,java.math.BigDecimal>	gammaFactors(java.util.Set<MRVMLicense> bundle)	Calculates the gamma factors for all regions.
int	getHomeId()
<T extends BiddingLanguage> T	getValueFunction(java.lang.Class<T> type, RNGSupplier rngSupplier)
int	hashCode()
void	refreshReference(World world)	To prevent from creating too many identical world instances, worlds are not serialized and deserialized with the bidder As a temporary solution, the world instance is re-added after deserialization by calling this method. This method will be removed in a later version and be done automatically during deserialization.

Methods inherited from class org.spectrumauctions.sats.core.model.mrvm.MRVMBidder

calculateValue, canEqual, getAllocationLimit, getAlpha, getBestBundles, getBeta, getWorld, getzHigh, getzLow, omegaFactor, setAllocationLimit, svFunction, svFunction

Methods inherited from class org.spectrumauctions.sats.core.model.SATSBidder

getDescription, getId, getLongId, getMipInstrumentation, getName, getPopulation, getSetup, getSetupType, getShortDescription, getStrategy, getValue, getValueFunction, getValueFunction, getWorldId, setMipInstrumentation, setStrategy, store, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.marketdesignresearch.mechlib.core.bidder.Bidder

getBestBundle, getBestBundles, getUtility, getValue, getValue, getValue

Method Detail

getHomeId

public int getHomeId()

gammaFactor

public java.math.BigDecimal gammaFactor(MRVMRegionsMap.Region r,
                                        java.util.Set<MRVMLicense> bundle)

Calculates the gamma factor, as explained in the model writeup.
The gamma factor represents a bidder-specific discount of the the regional (omega) values. If the two regions are not disconnected, the value is 0.

Specified by:

gammaFactor in class MRVMBidder

Parameters:

bundle - Is not required for calculation of regional bidders gamma factors and will be ignored.

r - The region for which the discount is requested

gammaFactors

public java.util.Map<MRVMRegionsMap.Region,java.math.BigDecimal> gammaFactors(java.util.Set<MRVMLicense> bundle)

Calculates the gamma factors for all regions. For explanations of the gamma factors, see MRVMBidder.gammaFactor(MRVMRegionsMap.Region, Set)

Specified by:

gammaFactors in class MRVMBidder

Parameters:

bundle - Is not required for calculation of regional bidders gamma factors and will be ignored.

drawSimilarBidder

public MRVMRegionalBidder drawSimilarBidder(RNGSupplier rngSupplier)

Specified by:

drawSimilarBidder in class SATSBidder

getValueFunction

public <T extends BiddingLanguage> T getValueFunction(java.lang.Class<T> type,
                                                      RNGSupplier rngSupplier)
                                               throws UnsupportedBiddingLanguageException

Overrides:

getValueFunction in class MRVMBidder

Throws:

UnsupportedBiddingLanguageException

refreshReference

public void refreshReference(World world)

Description copied from class: SATSBidder

To prevent from creating too many identical world instances, worlds are not serialized and deserialized with the bidder
As a temporary solution, the world instance is re-added after deserialization by calling this method.

This method will be removed in a later version and be done automatically during deserialization.

Overrides:

refreshReference in class MRVMBidder

See Also:

SATSBidder.refreshReference(World)

hashCode

public int hashCode()

Overrides:

hashCode in class MRVMBidder

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class MRVMBidder

bidderTypeSpecificDemandQueryMIPAdjustments

protected void bidderTypeSpecificDemandQueryMIPAdjustments(MRVM_MIP mip)

Description copied from class: MRVMBidder

Allows a specific bidder type (subclass) to change the demand query mip before execution. I.e. restrict demand query result to items where the bidder is interested in.

Specified by:

bidderTypeSpecificDemandQueryMIPAdjustments in class MRVMBidder