def make_bldg_neighbor(self, name):
bldg_powers = self.building_powers[name]
# Create neighbor
bldg = Neighbor()
bldg.name = name
bldg.maximumPower = bldg_powers[
0] # Remember loads have negative power [avg.kW]
bldg.minimumPower = bldg_powers[1] # [avg.kW]
_log.debug("{} has minPower of {} and maxPower of {}".format(
bldg.name, bldg.minimumPower, bldg.maximumPower))
# Create neighbor model
bldg_model = NeighborModel()
bldg_model.name = name + '_Model'
bldg_model.location = self.name
bldg_model.convergenceThreshold = 0.02
bldg_model.friend = True
bldg_model.transactive = True
bldg_model.costParameters = [0, 0, 0]
# This is different building to building
bldg_model.defaultPower = bldg.minimumPower / 2 # bldg_powers[2] # [avg.kW]
bldg_model.defaultVertices = [
Vertex(float("inf"), 0, bldg_model.defaultPower, True)
]
# Cross reference object & model
bldg.model = bldg_model
bldg_model.object = bldg
return bldg
def make_campus(self):
# Campus object
campus = Neighbor()
campus.name = 'PNNL_Campus'
campus.description = 'PNNL_Campus'
campus.maximumPower = 0.0 # Remember loads have negative power [avg.kW]
campus.minimumPower = -20000 # [avg.kW]
# Campus model
campus_model = NeighborModel()
campus_model.name = 'PNNL_Campus_Model'
campus_model.location = self.name
campus_model.defaultPower = -10000 # [avg.kW]
campus_model.defaultVertices = [Vertex(0.045, 0.0, -10000.0)]
#campus_model.demandThreshold = 0.8 * campus.maximumPower
campus_model.transactive = True
# Cross-reference object & model
campus_model.object = campus
campus.model = campus_model
return campus
def make_supplier(self):
# Add supplier
supplier = Neighbor()
supplier.name = 'BPA'
supplier.description = 'The Bonneville Power Administration as electricity supplier to the City of Richland, WA'
supplier.lossFactor = self.supplier_loss_factor
supplier.maximumPower = 200800 # [avg.kW, twice the average COR load]
supplier.minimumPower = 0.0 # [avg.kW, will not export]
# Add supplier model
supplierModel = BulkSupplier_dc()
supplierModel.name = 'BPAModel'
#supplierModel.demandThreshold = 0.75 * supplier.maximumPower
supplierModel.converged = False # Dynamically assigned
supplierModel.convergenceThreshold = 0 # Not yet implemented
supplierModel.effectiveImpedance = 0.0 # Not yet implemented
supplierModel.friend = False # Separate business entity from COR
supplierModel.transactive = False # Not a transactive neighbor
# Add vertices
# The first default vertex is, for now, based on the flat COR rate to
# PNNL. The second vertex includes 2# losses at a maximum power that
# is twice the average electric load for COR. This is helpful to
# ensure that a unique price, power point will be found. In this
# model the recipient pays the cost of energy losses.
# The first vertex is based on BPA Jan HLH rate at zero power
# importation.
d1 = Vertex(0, 0, 0) # create first default vertex
d1.marginalPrice = 0.04196 # HLH BPA rate Jan 2018 [$/kWh]
d1.cost = 2000.0 # Const. price shift to COR customer rate [$/h]
d1.power = 0.0 # [avg.kW]
# The second default vertex represents imported and lost power at a power
# value presumed to be the maximum deliverable power from BPA to COR.
d2 = Vertex(0, 0, 0) # create second default vertex
# COR pays for all sent power but receives an amount reduced by
# losses. This creates a quadratic term in the production cost and
# a slope to the marginal price curve.
d2.marginalPrice = d1.marginalPrice / (1 - supplier.lossFactor
) # [$/kWh]
# From the perspective of COR, it receives the power sent by BPA,
# less losses.
d2.power = (1 -
supplier.lossFactor) * supplier.maximumPower # [avg.kW]
# The production costs can be estimated by integrating the
# marginal-price curve.
d2.cost = d1.cost + d2.power * (d1.marginalPrice + 0.5 *
(d2.marginalPrice - d1.marginalPrice)
) # [$/h]
supplierModel.defaultVertices = [d1, d2]
# COST PARAMTERS
# A constant cost parameter is being used here to account for the
# difference between wholesale BPA rates to COR and COR distribution
# rates to customers like PNNL. A constant of $2,000/h steps the rates
# from about 0.04 $/kWh to about 0.06 $/kWh. This may be refined later.
# IMPORTANT: This shift has no affect on marginal pricing.
supplierModel.costParameters[0] = 2000.0 # [$/h]
# Cross-reference object & model
supplierModel.object = supplier
supplier.model = supplierModel
# Meter
bpaElectricityMeter = MeterPoint() # Instantiate an electricity meter
bpaElectricityMeter.name = 'BpaElectricityMeter'
bpaElectricityMeter.description = 'BPA electricity to COR'
bpaElectricityMeter.measurementType = MeasurementType.PowerReal
bpaElectricityMeter.measurementUnit = MeasurementUnit.kWh
supplierModel.meterPoints = [bpaElectricityMeter]
return supplier
def init_objects(self):
# Add meter
# meter = MeterPoint()
# meter.name = 'BuildingElectricMeter'
# meter.measurementType = MeasurementType.PowerReal
# meter.measurementUnit = MeasurementUnit.kWh
# self.meterPoints.append(meter)
# Add weather forecast service
weather_service = TemperatureForecastModel(self.config_path, self)
self.informationServiceModels.append(weather_service)
# # Add inelastive asset
# inelastive_load = LocalAsset()
# inelastive_load.name = 'InelasticBldgLoad'
# inelastive_load.maximumPower = 0 # Remember that a load is a negative power [kW]
# inelastive_load.minimumPower = -200
#
# # Add inelastive asset model
# inelastive_load_model = LocalAssetModel()
# inelastive_load_model.name = 'InelasticBuildingModel'
# inelastive_load_model.defaultPower = -100 # [kW]
# inelastive_load_model.defaultVertices = [Vertex(float("inf"), 0, -100, True)]
#
# # Cross-reference asset & asset model
# inelastive_load_model.object = inelastive_load
# inelastive_load.model = inelastive_load_model
# Add elastive asset
elastive_load = LocalAsset()
elastive_load.name = 'TccLoad'
elastive_load.maximumPower = 0 # Remember that a load is a negative power [kW]
elastive_load.minimumPower = -self.max_deliver_capacity
# Add inelastive asset model
# self.elastive_load_model = LocalAssetModel()
self.elastive_load_model = TccModel()
self.elastive_load_model.name = 'TccModel'
self.elastive_load_model.defaultPower = -0.5*self.max_deliver_capacity # [kW]
self.elastive_load_model.defaultVertices = [Vertex(0.055, 0, -self.elastive_load_model.defaultPower, True),
Vertex(0.06, 0, -self.elastive_load_model.defaultPower/2, True)]
# Cross-reference asset & asset model
self.elastive_load_model.object = elastive_load
elastive_load.model = self.elastive_load_model
# Add inelastive and elastive loads as building' assets
self.localAssets.extend([elastive_load])
# Add Market
market = Market()
market.name = 'dayAhead'
market.commitment = False
market.converged = False
market.defaultPrice = 0.0428 # [$/kWh]
market.dualityGapThreshold = self.duality_gap_threshold # [0.02 = 2#]
market.initialMarketState = MarketState.Inactive
market.marketOrder = 1 # This is first and only market
market.intervalsToClear = 1 # Only one interval at a time
market.futureHorizon = timedelta(hours=24) # Projects 24 hourly future intervals
market.intervalDuration = timedelta(hours=1) # [h] Intervals are 1 h long
market.marketClearingInterval = timedelta(hours=1) # [h]
market.marketClearingTime = Timer.get_cur_time().replace(hour=0,
minute=0,
second=0,
microsecond=0) # Aligns with top of hour
market.nextMarketClearingTime = market.marketClearingTime + timedelta(hours=1)
self.markets.append(market)
# Campus object
campus = Neighbor()
campus.name = 'PNNL_Campus'
campus.description = 'PNNL_Campus'
campus.maximumPower = self.max_deliver_capacity
campus.minimumPower = 0. # [avg.kW]
campus.lossFactor = self.campus_loss_factor
# Campus model
campus_model = NeighborModel()
campus_model.name = 'PNNL_Campus_Model'
campus_model.location = self.name
campus_model.defaultVertices = [Vertex(0.045, 25, 0, True), Vertex(0.048, 0, self.max_deliver_capacity, True)]
campus_model.demand_threshold_coef = self.demand_threshold_coef
# campus_model.demandThreshold = self.demand_threshold_coef * self.monthly_peak_power
campus_model.demandThreshold = self.monthly_peak_power
campus_model.transactive = True
campus_model.inject(self, system_loss_topic=self.system_loss_topic)
# Avg building meter
building_meter = MeterPoint()
building_meter.name = self.name + ' ElectricMeter'
building_meter.measurementType = MeasurementType.AverageDemandkW
building_meter.measurementUnit = MeasurementUnit.kWh
campus_model.meterPoints.append(building_meter)
# Cross-reference object & model
campus_model.object = campus
campus.model = campus_model
self.campus = campus
# Add campus as building's neighbor
self.neighbors.append(campus)
def init_objects(self):
# Add meter
meter = MeterPoint()
meter.measurementType = MeasurementType.PowerReal
meter.name = 'CampusElectricityMeter'
meter.measurementUnit = MeasurementUnit.kWh
self.meterPoints.append(meter)
# Add weather forecast service
weather_service = TemperatureForecastModel(self.config_path, self)
self.informationServiceModels.append(weather_service)
# Add inelastive asset
inelastive_load = LocalAsset()
inelastive_load.name = 'InelasticBuildings' # Campus buildings that are not responsive
inelastive_load.maximumPower = 0 # Remember that a load is a negative power [kW]
inelastive_load.minimumPower = -2 * 8200 # Assume twice the average PNNL load [kW]
# Add inelastive asset model
inelastive_load_model = OpenLoopPnnlLoadPredictor(weather_service)
inelastive_load_model.name = 'InelasticBuildingsModel'
inelastive_load_model.engagementCost = [
0, 0, 0
] # Transition costs irrelevant
inelastive_load_model.defaultPower = -6000 # [kW]
inelastive_load_model.defaultVertices = [Vertex(0, 0, -6000.0, 1)]
# Cross-reference asset & asset model
inelastive_load_model.object = inelastive_load
inelastive_load.model = inelastive_load_model
# Add solar PV asset
solar_pv = SolarPvResource()
solar_pv.maximumPower = self.PV_max_kW # [avg.kW]
solar_pv.minimumPower = 0.0 # [avg.kW]
solar_pv.name = 'SolarPv'
solar_pv.description = '120 kW solar PV site on the campus'
# Add solar PV asset model
solar_pv_model = SolarPvResourceModel()
solar_pv_model.cloudFactor = 1.0 # dimensionless
solar_pv_model.engagementCost = [0, 0, 0]
solar_pv_model.name = 'SolarPvModel'
solar_pv_model.defaultPower = 0.0 # [avg.kW]
solar_pv_model.defaultVertices = [Vertex(0, 0, 30.0, True)]
solar_pv_model.costParameters = [0, 0, 0]
solar_pv_model.inject(self, power_topic=self.solar_topic)
# Cross-reference asset & asset model
solar_pv.model = solar_pv_model
solar_pv_model.object = solar_pv
# Add inelastive and solar_pv as campus' assets
self.localAssets.extend([inelastive_load, solar_pv])
# Add Market
market = Market()
market.name = 'dayAhead'
market.commitment = False
market.converged = False
market.defaultPrice = 0.04 # [$/kWh]
market.dualityGapThreshold = self.duality_gap_threshold # [0.02 = 2#]
market.initialMarketState = MarketState.Inactive
market.marketOrder = 1 # This is first and only market
market.intervalsToClear = 1 # Only one interval at a time
market.futureHorizon = timedelta(
hours=24) # Projects 24 hourly future intervals
market.intervalDuration = timedelta(
hours=1) # [h] Intervals are 1 h long
market.marketClearingInterval = timedelta(hours=1) # [h]
market.marketClearingTime = Timer.get_cur_time().replace(
hour=0, minute=0, second=0,
microsecond=0) # Aligns with top of hour
market.nextMarketClearingTime = market.marketClearingTime + timedelta(
hours=1)
self.markets.append(market)
# City object
city = Neighbor()
city.name = 'CoR'
city.description = 'City of Richland (COR) electricity supplier node'
city.maximumPower = 20000 # Remember loads have negative power [avg.kW]
city.minimumPower = 0 # [avg.kW]
city.lossFactor = self.city_loss_factor
# City model
city_model = NeighborModel()
city_model.name = 'CoR_Model'
city_model.location = self.name
city_model.transactive = True
city_model.defaultPower = 10000 # [avg.kW]
city_model.defaultVertices = [
Vertex(0.046, 160, 0, True),
Vertex(0.048,
160 + city.maximumPower * (0.046 + 0.5 * (0.048 - 0.046)),
city.maximumPower, True)
]
city_model.costParameters = [0, 0, 0]
city_model.demand_threshold_coef = self.demand_threshold_coef
city_model.demandThreshold = self.monthly_peak_power
city_model.inject(self,
system_loss_topic=self.system_loss_topic,
dc_threshold_topic=self.dc_threshold_topic)
# Cross-reference object & model
city_model.object = city
city.model = city_model
self.city = city
# Add city as campus' neighbor
self.neighbors.append(city)
# Add buildings
for bldg_name in self.building_names:
bldg_neighbor = self.make_bldg_neighbor(bldg_name)
self.neighbors.append(bldg_neighbor)
def test_schedule():
print('Running AbstractModel.test_schedule()')
pf = 'pass'
# Create a test market test_mkt
test_mkt = Market()
# Create a sample time interval ti
dt = datetime.now()
at = dt
# NOTE: Function Hours() corrects behavior of Matlab hours().
dur = timedelta(hours=1)
mkt = test_mkt
mct = dt
# NOTE: Function Hours() corrects behavior of Matlab hours().
st = datetime.combine(date.today(), time()) + timedelta(hours=20)
ti = TimeInterval(at, dur, mkt, mct, st)
# Save the time interval
test_mkt.timeIntervals = [ti]
# Assign a marginal price in the time interval
test_mkt.check_marginal_prices()
# Create a Neighbor test object and give it a default maximum power value
test_obj = Neighbor()
test_obj.maximumPower = 100
# Create a corresponding NeighborModel
test_mdl = NeighborModel()
# Make sure that the model and object cross-reference one another
test_obj.model = test_mdl
test_mdl.object = test_obj
# Run a test with a NeighborModel object
print('- running test with a NeighborModel:')
test_mdl.schedule(test_mkt)
print(' - the method encountered no errors')
if len(test_mdl.scheduledPowers) != 1:
pf = 'fail'
raise ' - the method did not store a scheduled power'
else:
print(' - the method calculated and stored a scheduled power')
if len(test_mdl.reserveMargins) != 1:
pf = 'fail'
raise ' - the method did not store a reserve margin'
else:
print(' - the method stored a reserve margin')
if len(test_mdl.activeVertices) != 1:
pf = 'fail'
raise ' - the method did not store an active vertex'
else:
print(' - the method stored an active vertex')
# Run a test again with a LocalAssetModel object
test_obj = LocalAsset()
test_obj.maximumPower = 100
test_mdl = LocalAssetModel()
test_obj.model = test_mdl
test_mdl.object = test_obj
print('- running test with a LocalAssetModel:')
test_mdl.schedule(test_mkt)
print(' - the method encountered no errors')
if len(test_mdl.scheduledPowers) != 1:
pf = 'fail'
raise ' - the method did not store a scheduled power'
else:
print(' - the method calculated and stored a scheduled power')
if len(test_mdl.reserveMargins) != 1:
pf = 'fail'
raise ' - the method did not store a reserve margin'
else:
print(' - the method stored a reserve margin')
if len(test_mdl.activeVertices) != 1:
pf = 'fail'
raise ' - the method did not store an active vertex'
else:
print(' - the method stored an active vertex')
# Success
print('- the test ran to completion')
print('Result: %s', pf)
def test_schedule():
print('Running Market.test_schedule()')
print('WARNING: This test may be affected by NeighborModel.schedule()')
print('WARNING: This test may be affected by NeighborModel.schedule()')
pf = 'pass'
# Establish a myTransactiveNode object
mtn = myTransactiveNode()
# Establish a test market
test_mkt = Market()
# Create and store one TimeInterval
dt = datetime(2018, 1, 1, 12, 0, 0) # Noon Jan 1, 2018
at = dt
dur = timedelta(hours=1)
mkt = test_mkt
mct = dt
st = dt
ti = TimeInterval(at, dur, mkt, mct, st)
test_mkt.timeIntervals = [ti]
# Create and store a marginal price in the active interval.
test_mkt.marginalPrices = [
IntervalValue(test_mkt, ti, test_mkt, MeasurementType.MarginalPrice,
0.01)
]
print('- configuring a test Neighbor and its NeighborModel')
# Create a test object that is a Neighbor
test_obj1 = Neighbor()
test_obj1.maximumPower = 100
# Create the corresponding model that is a NeighborModel
test_mdl1 = NeighborModel()
test_mdl1.defaultPower = 10
test_obj1.model = test_mdl1
test_mdl1.object = test_obj1
mtn.neighbors = [test_obj1]
print('- configuring a test LocalAsset and its LocalAssetModel')
# Create a test object that is a Local Asset
test_obj2 = LocalAsset
test_obj2.maximumPower = 100
# Create the corresponding model that is a LocalAssetModel
test_mdl2 = LocalAssetModel()
test_mdl2.defaultPower = 10
test_obj2.model = test_mdl2
test_mdl2.object = test_obj2
mtn.localAssets = [test_obj2]
try:
test_mkt.schedule(mtn)
print('- method ran without errors')
except:
raise ('- method did not run due to errors')
if len(test_mdl1.scheduledPowers) != 1:
raise (
'- the wrong numbers of scheduled powers were stored for the Neighbor'
)
else:
print(
'- the right number of scheduled powers were stored for the Neighbor'
)
if len(test_mdl2.scheduledPowers) != 1:
raise (
'- the wrong numbers of scheduled powers were stored for the LocalAsset'
)
else:
print(
'- the right number of scheduled powers were stored for the LocalAsset'
)
# Success
print('- the test ran to completion')
print('Result: #s\n\n', pf)