org.spectrumauctions.sats.core.model.mrvm

Class MRVMBidderSetup

java.lang.Object

org.spectrumauctions.sats.core.model.BidderSetup

org.spectrumauctions.sats.core.model.mrvm.MRVMBidderSetup

Direct Known Subclasses:

MRVMLocalBidderSetup, MRVMNationalBidderSetup, MRVMRegionalBidderSetup

public abstract class MRVMBidderSetup
extends BidderSetup

Author:

Michael Weiss

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MRVMBidderSetup.Builder

Field Summary

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

numberOfBidders, setupName

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MRVMBidderSetup(MRVMBidderSetup.Builder builder)

Method Summary

Modifier and Type	Method and Description
BigDecimal	drawAlpha(UniformDistributionRNG rng) Draws the Alpha-Parameter uniformly at random. Alpha is a parameter defining an expected profit per served customer, if quality of service and regional discount are ignored. It can be understood as a relative bidder strength parameter.
BigDecimal	drawBeta(MRVMRegionsMap.Region r, UniformDistributionRNG rng) Draws the Beta-Parameter uniformly at random. Beta is a parameter defining the target market share this bidder intends to cover.
HashMap<Integer,BigDecimal>	drawZHigh(Map<Integer,BigDecimal> betas, MRVMWorld world, UniformDistributionRNG rng)
HashMap<Integer,BigDecimal>	drawZLow(Map<Integer,BigDecimal> betas, MRVMWorld world, 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

Constructor Detail

MRVMBidderSetup

protected MRVMBidderSetup(MRVMBidderSetup.Builder builder)

Method Detail

drawAlpha

public BigDecimal drawAlpha(UniformDistributionRNG rng)

Draws the Alpha-Parameter uniformly at random.
Alpha is a parameter defining an expected profit per served customer, if quality of service and regional discount are ignored.
It can be understood as a relative bidder strength parameter.

Returns:

a BigDecimal in [0,1]

drawBeta

public BigDecimal drawBeta(MRVMRegionsMap.Region r,
                           UniformDistributionRNG rng)

Draws the Beta-Parameter uniformly at random.
Beta is a parameter defining the target market share this bidder intends to cover.
The bidders value for a bundle increases heavily as soon as the capacity share he has in a region gets close to beta.

Returns:

a BigDecimal in [0,1]

drawZLow

public HashMap<Integer,BigDecimal> drawZLow(Map<Integer,BigDecimal> betas,
                                            MRVMWorld world,
                                            UniformDistributionRNG rng)

drawZHigh

public HashMap<Integer,BigDecimal> drawZHigh(Map<Integer,BigDecimal> betas,
                                             MRVMWorld world,
                                             UniformDistributionRNG rng)