Package 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	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	Description
protected java.util.Map<java.lang.String,DoubleInterval>	baseValueIntervals
protected java.util.Map<java.lang.String,IntegerInterval>	positiveValueThresholdIntervals
protected java.util.Map<java.lang.String,com.google.common.collect.ImmutableMap<java.lang.Integer,java.math.BigDecimal>>	synFactors

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

numberOfBidders, setupName

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BMBidderSetup(BMBidderSetup.BMBidderSetupBuilder builder)

Method Summary

Modifier and Type	Method	Description
java.math.BigDecimal	drawBaseValue(BMBand band, UniformDistributionRNG rng)
java.lang.Integer	drawPositiveValueThreshold(BMBand band, UniformDistributionRNG rng)
java.util.Map<java.lang.Integer,java.math.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 java.util.Map<java.lang.String,IntegerInterval> positiveValueThresholdIntervals

baseValueIntervals

protected final java.util.Map<java.lang.String,DoubleInterval> baseValueIntervals

synFactors

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

Constructor Detail

BMBidderSetup

protected BMBidderSetup(BMBidderSetup.BMBidderSetupBuilder builder)

Method Detail

drawPositiveValueThreshold

public java.lang.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 java.math.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 java.util.Map<java.lang.Integer,java.math.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.