Package org.powertac.common.interfaces

Interface CustomerModelAccessor

public interface CustomerModelAccessor
Defines an interface for access to customer model details that support tariff evaluation. This includes generation of per-tariff customer usage/production profiles. Required by TariffEvaluationHelper. Profiles can be for a full day, a full week, or whatever time period makes sense for the customer. Usage may be for a single individual customer or for the entire population. Results are normalized by the tariff evaluation process, so the only requirement is that all profiles for a given customer use the same time period (and the same weather), and the same population.
Author:
John Collins

  • Method Summary

    Modifier and Type Method Description
    double getBrokerSwitchFactor​(boolean isSuperseding)
    Returns a [0,1] value representing the inconvenience of switching brokers.
    CapacityProfile getCapacityProfile​(org.powertac.common.Tariff tariff)
    Returns a capacity profile for the given tariff.
    org.powertac.common.CustomerInfo getCustomerInfo()
    Returns the CustomerInfo instance for this customer model.
    double getInertiaSample()
    Returns a [0,1] random value used to choose whether individual customers evaluate tariffs or not.
    double getShiftingInconvenienceFactor​(org.powertac.common.Tariff tariff)
    Returns a [0,1] value representing the inconvenience of dealing with curtailment in exchange for a lower price.
    double getTariffChoiceSample()
    Returns a [0,1] random value used to make choices using the logit choice model.

  • Method Details

    • getCustomerInfo

      org.powertac.common.CustomerInfo getCustomerInfo()
      Returns the CustomerInfo instance for this customer model.

    • getCapacityProfile

      CapacityProfile getCapacityProfile​(org.powertac.common.Tariff tariff)
      Returns a capacity profile for the given tariff. This must represent the usage of a single individual in a population model over some model-specific time period.

    • getBrokerSwitchFactor

      double getBrokerSwitchFactor​(boolean isSuperseding)
      Returns a [0,1] value representing the inconvenience of switching brokers. The value may depend on whether the current subscription is being switched to a superseding tariff as a result of revocation.

    • getTariffChoiceSample

      double getTariffChoiceSample()
      Returns a [0,1] random value used to make choices using the logit choice model.

    • getInertiaSample

      double getInertiaSample()
      Returns a [0,1] random value used to choose whether individual customers evaluate tariffs or not.

    • getShiftingInconvenienceFactor

      double getShiftingInconvenienceFactor​(org.powertac.common.Tariff tariff)
      Returns a [0,1] value representing the inconvenience of dealing with curtailment in exchange for a lower price.