org.powertac.customer.model

Class Battery

java.lang.Object

org.powertac.customer.AbstractCustomer

org.powertac.customer.model.Battery

All Implemented Interfaces:

org.powertac.common.interfaces.CustomerModelAccessor

@Domain
 @ConfigurableInstance
public class Battery
extends org.powertac.customer.AbstractCustomer
implements org.powertac.common.interfaces.CustomerModelAccessor

Models a single grid-connected storage battery with configurable capacity, max charge rate, max discharge rate, and efficiency. Batteries do not charge unless used for regulation, so repeated use for up-regulation will leave them discharged, and repeated use for down-regulation will leave them fully charged. If not used at all, they will eventually end up completely discharged just in case their selfDischargeRate values are non-zero. The initial state-of-charge is always 0.0;

Author:

John Collins

Field Summary

Fields inherited from class org.powertac.customer.AbstractCustomer

allCustomerInfos, customerInfos, name, rs1, service

Constructor Summary

Constructors

Constructor and Description
Battery() Default constructor, requires manual setting of name
Battery(String name) Standard constructor for named configurable type

Method Summary

Modifier and Type	Method and Description
void	evaluateTariffs(List<org.powertac.common.Tariff> tariffs)
double	getBrokerSwitchFactor(boolean isSuperseding)
double	getCapacityKWh()
org.powertac.common.CapacityProfile	getCapacityProfile(org.powertac.common.Tariff tariff)
double	getChargeEfficiency()
org.powertac.common.CustomerInfo	getCustomerInfo()
double	getInertiaSample()
double	getMaxChargeKW()
double	getMaxDischargeKW()
String	getName()
double	getSelfDischargeRate()
double	getShiftingInconvenienceFactor(org.powertac.common.Tariff tariff)
double	getTariffChoiceSample()
void	initialize() Initialization must provide accessor to Customer instance and time.
void	setCapacityKWh(double value)
void	setChargeEfficiency(double value)
void	setMaxChargeKW(double value)
void	setMaxDischargeKW(double value)
void	setName(String name)
void	setSelfDischargeRate(double value)
void	step()

Methods inherited from class org.powertac.customer.AbstractCustomer

addCustomerInfo, changeSubscription, getCurrentSubscriptions, getCurrentSubscriptions, getCustId, getCustomerInfo, getCustomerInfoList, getCustomerInfos, getId, getPopulation, lastSunday, nextStartOfDay, saveBootstrapState, setServiceAccessor, setTariffMarket, startOfDay, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Battery

public Battery()

Default constructor, requires manual setting of name

Battery

public Battery(String name)

Standard constructor for named configurable type

Method Detail

initialize

public void initialize()

Initialization must provide accessor to Customer instance and time. We assume configuration has already happened. We start with the battery at its targetSOC.

Overrides:

initialize in class org.powertac.customer.AbstractCustomer

getCustomerInfo

public org.powertac.common.CustomerInfo getCustomerInfo()

Specified by:

getCustomerInfo in interface org.powertac.common.interfaces.CustomerModelAccessor

step

public void step()

Specified by:

step in class org.powertac.customer.AbstractCustomer

getName

public String getName()

Overrides:

getName in class org.powertac.customer.AbstractCustomer

setName

public void setName(String name)

Overrides:

setName in class org.powertac.customer.AbstractCustomer

setCapacityKWh

@ConfigurableValue(valueType="Double",
                   description="size of battery in kWh")
 @StateChange
public void setCapacityKWh(double value)

getCapacityKWh

public double getCapacityKWh()

setMaxChargeKW

@ConfigurableValue(valueType="Double",
                   description="maximum charge rate")
 @StateChange
public void setMaxChargeKW(double value)

getMaxChargeKW

public double getMaxChargeKW()

setMaxDischargeKW

@ConfigurableValue(valueType="Double",
                   description="Maximum discharge rate")
public void setMaxDischargeKW(double value)

getMaxDischargeKW

public double getMaxDischargeKW()

setChargeEfficiency

@ConfigurableValue(valueType="Double",
                   description="ratio of charge energy to battery energy")
 @StateChange
public void setChargeEfficiency(double value)

getChargeEfficiency

public double getChargeEfficiency()

setSelfDischargeRate

@ConfigurableValue(valueType="Double",
                   description="hourly charge lost as proportion of capacity")
public void setSelfDischargeRate(double value)

getSelfDischargeRate

public double getSelfDischargeRate()

getBrokerSwitchFactor

public double getBrokerSwitchFactor(boolean isSuperseding)

Specified by:

getBrokerSwitchFactor in interface org.powertac.common.interfaces.CustomerModelAccessor

getTariffChoiceSample

public double getTariffChoiceSample()

Specified by:

getTariffChoiceSample in interface org.powertac.common.interfaces.CustomerModelAccessor

getInertiaSample

public double getInertiaSample()

Specified by:

getInertiaSample in interface org.powertac.common.interfaces.CustomerModelAccessor

evaluateTariffs

public void evaluateTariffs(List<org.powertac.common.Tariff> tariffs)

Specified by:

evaluateTariffs in class org.powertac.customer.AbstractCustomer

getShiftingInconvenienceFactor

public double getShiftingInconvenienceFactor(org.powertac.common.Tariff tariff)

Specified by:

getShiftingInconvenienceFactor in interface org.powertac.common.interfaces.CustomerModelAccessor

getCapacityProfile

public org.powertac.common.CapacityProfile getCapacityProfile(org.powertac.common.Tariff tariff)

Specified by:

getCapacityProfile in interface org.powertac.common.interfaces.CustomerModelAccessor