org.spectrumauctions.sats.core.model.srvm

Class SRVMBidder

java.lang.Object

org.spectrumauctions.sats.core.model.Bidder<SRVMLicense>

org.spectrumauctions.sats.core.model.srvm.SRVMBidder

All Implemented Interfaces:

Serializable, GenericValueBidder<SRVMBand>

public final class SRVMBidder
extends Bidder<SRVMLicense>
implements GenericValueBidder<SRVMBand>

Author:

Michael Weiss

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
BigDecimal	calculateValue(Bundle<SRVMLicense> licenses) Returns the value this bidder has for a specific bundle.
BigDecimal	calculateValue(Map<SRVMBand,Integer> genericQuantities)
boolean	equals(Object obj)
Map<String,BigDecimal>	getBaseValues()
BigDecimal	getBidderStrength() This random value is used exclusively in {SRVMBidderSetup.drawBaseValues(SRVMWorld, BigDecimal, RNGSupplier), but stored in the bidder for easier analysis. Its mean is typically 1. Note that the bidder strength is not the only random influence on the base values, hence a high bidder strength does not imply that a bidder is stronger than others, it simply makes it more likely.
BigDecimal	getInterbandSynergyValue()
Map<String,BigDecimal>	getIntrabandSynergyFactors()
Map<String,Integer>	getSynergyThreshold()
<T extends BiddingLanguage> T	getValueFunction(Class<T> clazz, long seed) Use this method to get a desired value function representation (bidding language) for this bidder.
SRVMWorld	getWorld()
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.Bidder

getId, getPopulation, getSetupType, getValue, getValueFunction, getWorldId, store

Methods inherited from class java.lang.Object

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

Method Detail

getWorld

public SRVMWorld getWorld()

Specified by:

getWorld in class Bidder<SRVMLicense>

Returns:

World to which this bidder belongs. The implementing Bidder class, overriding this method, should return a world type corresponding to the specific model.

getBidderStrength

public BigDecimal getBidderStrength()

This random value is used exclusively in {SRVMBidderSetup.drawBaseValues(SRVMWorld, BigDecimal, RNGSupplier), but stored in the bidder for easier analysis.
Its mean is typically 1.

Note that the bidder strength is not the only random influence on the base values, hence a high bidder strength does not imply that a bidder is stronger than others, it simply makes it more likely.

Returns:

the bidder strength

getSynergyThreshold

public Map<String,Integer> getSynergyThreshold()

getBaseValues

public Map<String,BigDecimal> getBaseValues()

getIntrabandSynergyFactors

public Map<String,BigDecimal> getIntrabandSynergyFactors()

getInterbandSynergyValue

public BigDecimal getInterbandSynergyValue()

calculateValue

public BigDecimal calculateValue(Bundle<SRVMLicense> licenses)

Description copied from class: Bidder

Returns the value this bidder has for a specific bundle.

Specified by:

calculateValue in class Bidder<SRVMLicense>

Parameters:

licenses - the bundle for which the value is asked

Returns:

bidder specific value for this bundle

calculateValue

public BigDecimal calculateValue(Map<SRVMBand,Integer> genericQuantities)

Specified by:

calculateValue in interface GenericValueBidder<SRVMBand>

See Also:

GenericValueBidder.calculateValue(java.util.Map)

getValueFunction

public <T extends BiddingLanguage> T getValueFunction(Class<T> clazz,
                                                      long seed)
                                               throws UnsupportedBiddingLanguageException

Description copied from class: Bidder

Use this method to get a desired value function representation (bidding language) for this bidder. Note that this method may cause your compiler to throw a warning, as the generics of generic Bidding Languages (such as XOR) is not specified in .class. generic

Specified by:

getValueFunction in class Bidder<SRVMLicense>

Parameters:

clazz - the type of the value function

Returns:

the value function of this bidder

Throws:

UnsupportedBiddingLanguageException - Throws this exception for all bidding languages which are not supported by the implementing bidder class. This javadoc should be extended by the implementing class, specifying which value function representation are supported.

refreshReference

public void refreshReference(World world)

Description copied from class: Bidder

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.

Specified by:

refreshReference in class Bidder<SRVMLicense>

See Also:

Bidder.refreshReference(World)

hashCode

public int hashCode()

Overrides:

hashCode in class Bidder<SRVMLicense>

equals

public boolean equals(Object obj)

Overrides:

equals in class Bidder<SRVMLicense>