org.spectrumauctions.sats.core.model.bvm

Class BMBidderSetup

java.lang.Object

org.spectrumauctions.sats.core.model.BidderSetup

org.spectrumauctions.sats.core.model.bvm.BMBidderSetup

Direct Known Subclasses:

BVMBidderSetup, MBVMBidderSetup

public abstract class BMBidderSetup
extends BidderSetup

A configuration of a Bidder, i.e., the specification of the random parameters of the bidder.

Author:

Michael Weiss

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BMBidderSetup.BMBidderSetupBuilder

Nested classes/interfaces inherited from class org.spectrumauctions.sats.core.model.BidderSetup

BidderSetup.Builder

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,DoubleInterval>	baseValueIntervals
protected Map<String,IntegerInterval>	positiveValueThresholdIntervals
protected Map<String,com.google.common.collect.ImmutableMap<Integer,BigDecimal>>	synFactors

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

numberOfBidders, setupName

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BMBidderSetup(BMBidderSetup.BMBidderSetupBuilder builder)

Method Summary

Modifier and Type	Method and Description
BigDecimal	drawBaseValue(BMBand band, UniformDistributionRNG rng)
Integer	drawPositiveValueThreshold(BMBand band, UniformDistributionRNG rng)
Map<Integer,BigDecimal>	drawSynergyFactors(BMBand band, UniformDistributionRNG rng)

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

getNumberOfBidders, getSetupName

Methods inherited from class java.lang.Object

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

Field Detail

positiveValueThresholdIntervals

protected final Map<String,IntegerInterval> positiveValueThresholdIntervals

baseValueIntervals

protected final Map<String,DoubleInterval> baseValueIntervals

synFactors

protected final Map<String,com.google.common.collect.ImmutableMap<Integer,BigDecimal>> synFactors

Constructor Detail

BMBidderSetup

protected BMBidderSetup(BMBidderSetup.BMBidderSetupBuilder builder)

Method Detail

drawPositiveValueThreshold

public Integer drawPositiveValueThreshold(BMBand band,
                                          UniformDistributionRNG rng)

Returns:

the threshold defining the quantity of licences per band, for which this bidder has a strictly positive value. For quantities exceeding this threshold, a bidder does not have additional value (free disposal).

drawBaseValue

public BigDecimal drawBaseValue(BMBand band,
                                UniformDistributionRNG rng)

Returns:

the base value of a band is a bidder specific valuation a bidder has per license of the specified band, ignoring synergies and value thresholds

drawSynergyFactors

public Map<Integer,BigDecimal> drawSynergyFactors(BMBand band,
                                                  UniformDistributionRNG rng)

Returns:

the parameter defining the intra-band synergies the bidder has from having multiple licenses in the same band.