Package org.spectrumauctions.sats.core.model.lsvm

Class LSVMBidder

  • All Implemented Interfaces:
    java.io.Serializable, org.marketdesignresearch.mechlib.core.bidder.Bidder, org.marketdesignresearch.mechlib.instrumentation.MipInstrumentationable
    public final class LSVMBidder
extends SATSBidder
    Author:
    Fabio Isler
    See Also:
    Serialized Form

    • Method Detail

      • getProximity

        public com.google.common.collect.ImmutableSet<LSVMLicense> getProximity()

      • calculateValue

        public java.math.BigDecimal calculateValue​(org.marketdesignresearch.mechlib.core.Bundle bundle)
        Description copied from class: SATSBidder
        Returns the value this bidder has for a specific bundle.
        Specified by:
        calculateValue in class SATSBidder
        Parameters:
        bundle - the bundle for which the value is asked
        Returns:
        bidder specific value for this bundle

      • getWorld

        public LSVMWorld getWorld()
        Specified by:
        getWorld in class SATSBidder
        Returns:
        World to which this bidder belongs. The implementing Bidder class, overriding this method, should return a world type corresponding to the specific model.
        See Also:
        SATSBidder.getWorld()

      • 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.
        Specified by:
        refreshReference in class SATSBidder

      • getBaseValues

        public java.util.Map<java.lang.Long,​java.math.BigDecimal> getBaseValues()

      • calculateFactor

        public double calculateFactor​(int size)
        This factor is used to calculate the bonus for having adjacent items.

        Note: The current interpretation of Scheffel et al. (2010) is such that a bidder has no positive marginal value for any licenses he is not interested in. (I.e. adding or removing such a license from a bundle does not change the value of the bundle). There are mainly two arguments for this interpretation: 1. Scheffel et al. (2010) states that the bidding space of the regional bidder consists of 63 - 2047 packages (bundles). As a regional bidder is interested in 6 to 11 licenses this makes clear that the bidding space of a regional bidder does not include any licences he is not interested in 2. This interpretation follows the implementation of GSVM where items of no interest have no influence on the bundle values. The interpretation which was used to implement the legacy version of LVSM is stated as Note II. In addition to this note you may notice that licenses where a bidder has no interest in, do not only affect the computation of maximally connected subsets of licenses, but also increases the synergies in the legacy version. I.e. assume a bundle of 3 licenses DEJ. The bidder is only interested in licenses E and J. (see table 1 in Scheffel et al. (2010)). In the current version no synergies will be applied to this package. The legacy version will apply synergies for 3 licenses. Note II could also be interpreted towards that only synergies for 2 licenses are applied and the license of no interest (D) is only used to compute maximally connected subpackages. This last interpretation is not implemented in any version of LSVM in sats. Note II: To our knowledge, Scheffel et al. (2010) do not specify the behavior in case a license is added which the bidder does not have any interest in. This one license could connect two subsets of items which the bidder is interested in, creating one larger subset, thus increasing the bonus for adjacent items. A possible extension of the model is to adjust the bonus accordingly in this situation. Currently, SATS doesn't prevent this behavior, sticking to the original model.

      • getBestBundles

        public java.util.LinkedHashSet<org.marketdesignresearch.mechlib.core.Bundle> getBestBundles​(org.marketdesignresearch.mechlib.core.price.Prices prices,
                                                                                            int maxNumberOfBundles,
                                                                                            boolean allowNegative)

      • getDescription

        public java.lang.String getDescription()
        Specified by:
        getDescription in interface org.marketdesignresearch.mechlib.core.bidder.Bidder
        Overrides:
        getDescription in class SATSBidder