Package org.powertac.tariffmarket

Class CapacityControlService

java.lang.Object

org.powertac.common.interfaces.TimeslotPhaseProcessor

org.powertac.tariffmarket.CapacityControlService

All Implemented Interfaces:

CapacityControl, InitializationService

@Service
public class CapacityControlService
extends TimeslotPhaseProcessor
implements CapacityControl, InitializationService

Service for managing balancing and economic controls.

Author:

John Collins

Constructor Summary

Constructors

Constructor	Description
CapacityControlService()

Method Summary

Modifier and Type	Method	Description
void	activate(org.joda.time.Instant time, int phaseNumber)	Activation applies pending ratio controls to subscriptions for the current timeslot.
void	exerciseBalancingControl(BalancingOrder order, double kwh, double payment)	Creates BalancingControlEvent, posts it on correct TariffSubscription instances.
RegulationAccumulator	getRegulationCapacity(BalancingOrder order)	Gathers up power usage data for the current timeslot that could be subject to a BalancingOrder.
String	initialize(Competition competition, List<String> completedInits)	Initializes a plugin prior to the beginning of a game.
void	postEconomicControl(EconomicControlEvent event)	Posts an EconomicControlEvent on the correct TariffSubscription instances.

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

CapacityControlService

public CapacityControlService()

Method Detail

initialize

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

Description copied from interface: InitializationService

Initializes a plugin prior to the beginning of a game. The completedInits parameter is the list of plugin role names that have been successfully initialized. If sequence dependencies are satisfied (or if there are no sequence dependencies), then an implementation must complete its pre-game initialization process and return its role name. If sequence dependencies are not satisfied, then an implementation must return null. It will be called again after additional successful initializations have been completed. If initialization is not possible, then returning the string 'fail' will cause the server to log an error and shut down. This will be helpful just in case the implementation also logs a detailed error message.

Specified by:

initialize in interface InitializationService

exerciseBalancingControl

public void exerciseBalancingControl(BalancingOrder order,
                                     double kwh,
                                     double payment)

Description copied from interface: CapacityControl

Creates BalancingControlEvent, posts it on correct TariffSubscription instances. Up-regulation is represented by positive kwh (the market is getting more energy) and typically positive payment.

Specified by:

exerciseBalancingControl in interface CapacityControl

postEconomicControl

public void postEconomicControl(EconomicControlEvent event)

Description copied from interface: CapacityControl

Posts an EconomicControlEvent on the correct TariffSubscription instances.

Specified by:

postEconomicControl in interface CapacityControl

getRegulationCapacity

public RegulationAccumulator getRegulationCapacity(BalancingOrder order)

Description copied from interface: CapacityControl

Gathers up power usage data for the current timeslot that could be subject to a BalancingOrder. Return value is in kwh.

Specified by:

getRegulationCapacity in interface CapacityControl

activate

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

Activation applies pending ratio controls to subscriptions for the current timeslot.

Specified by:

activate in class TimeslotPhaseProcessor