org.powertac.balancemkt

Class BalancingMarketService

java.lang.Object

org.powertac.common.interfaces.TimeslotPhaseProcessor

org.powertac.balancemkt.BalancingMarketService

All Implemented Interfaces:

SettlementContext, BalancingMarket, InitializationService

@Service
public class BalancingMarketService
extends TimeslotPhaseProcessor
implements BalancingMarket, SettlementContext, InitializationService

Constructor Summary

Constructors

Constructor and Description
BalancingMarketService()

Method Summary

Modifier and Type	Method and Description
void	activate(org.joda.time.Instant time, int phaseNumber) This method gets called once during each timeslot.
Map<Broker,ChargeInfo>	balanceTimeslot(List<Broker> brokerList, org.powertac.balancemkt.BalancingMarketService.DoubleWrapper report) Generates a list of Transactions that balance the overall market.
Double	getBalancingCost() Returns the per-timeslot charge for running the balancing market
double	getDefaultSpotPrice() Returns the value used for spot price per MWh if unavailable from wholesale market.
double	getMarketBalance(Broker broker) Returns the difference between a broker's current market position and its net load.
double	getPMinus() Returns the minimum price for energy in the current timeslot
double	getPMinusPrime() Returns the slope of cost curve for down-regulation.
double	getPPlus() Returns the maximum price for energy in the current timeslot.
double	getPPlusPrime() Returns the slope of cost curve for up-regulation.
double	getRegulation(Broker broker) Returns the net balancing result for a given broker.
String	initialize(Competition competition, List<String> completedInits) Computes actual distribution and balancing costs by random selection

Methods inherited from class org.powertac.common.interfaces.TimeslotPhaseProcessor

init, setTimeslotPhase

Methods inherited from class java.lang.Object

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

Constructor Detail

BalancingMarketService

public BalancingMarketService()

Method Detail

initialize

public String initialize(Competition competition,
                         List<String> completedInits)

Computes actual distribution and balancing costs by random selection

Specified by:

initialize in interface InitializationService

activate

public void activate(org.joda.time.Instant time,
                     int phaseNumber)

Description copied from class: TimeslotPhaseProcessor

This method gets called once during each timeslot. To get called, the module must first call the register(phaseNumber) method on CompetitionControl. The call will give the current simulation time and phase number in the arguments.

Specified by:

activate in class TimeslotPhaseProcessor

balanceTimeslot

public Map<Broker,ChargeInfo> balanceTimeslot(List<Broker> brokerList,
                                              org.powertac.balancemkt.BalancingMarketService.DoubleWrapper report)

Generates a list of Transactions that balance the overall market. Transactions are generated on a per-broker basis depending on the broker's balance within its own market.

Returns:

List of ChargeInfo instances

getMarketBalance

public double getMarketBalance(Broker broker)

Returns the difference between a broker's current market position and its net load. Note: market position is computed in MWh and net load is computed in kWh, conversion is needed to compute the difference in kWh.

Specified by:

getMarketBalance in interface BalancingMarket

Returns:

a broker's current energy balance within its market. Pos for over-production, neg for under-production

getRegulation

public double getRegulation(Broker broker)

Returns the net balancing result for a given broker. Valid only after service activation within a given timeslot.

Specified by:

getRegulation in interface BalancingMarket

getPPlus

public double getPPlus()

Returns the maximum price for energy in the current timeslot. Units are per kWh

Specified by:

getPPlus in interface SettlementContext

getPMinus

public double getPMinus()

Returns the minimum price for energy in the current timeslot

Specified by:

getPMinus in interface SettlementContext

getPPlusPrime

public double getPPlusPrime()

Description copied from interface: BalancingMarket

Returns the slope of cost curve for up-regulation. Total cost for up-regulation by x kwh is pPlus + x * pPlusPrime. Note that x is positive for up-regulation.

Specified by:

getPPlusPrime in interface BalancingMarket

getPMinusPrime

public double getPMinusPrime()

Description copied from interface: BalancingMarket

Returns the slope of cost curve for down-regulation. Total cost for down-regulation by x kwh is pMinus + x * pMinusPrime. Note that x is negative for down-regulation.

Specified by:

getPMinusPrime in interface BalancingMarket

getBalancingCost

public Double getBalancingCost()

Description copied from interface: BalancingMarket

Returns the per-timeslot charge for running the balancing market

Specified by:

getBalancingCost in interface BalancingMarket

getDefaultSpotPrice

public double getDefaultSpotPrice()

Description copied from interface: BalancingMarket

Returns the value used for spot price per MWh if unavailable from wholesale market.

Specified by:

getDefaultSpotPrice in interface BalancingMarket