dragonfly_energy.des.ets module

Building Energy Transfer Stations (ETS) within district energy systems.

class dragonfly_energy.des.ets.HeatExchangerETS(cooling_supply_temp=5, heating_supply_temp=50, exchanger_efficiency=0.8, primary_pressure_drop=500, secondary_pressure_drop=500)[source]

Bases: object

Represents a Building Energy Transfer Station (ETS) within a fourth generation DES.

This ETS uses a fluid-to-fluid heat exchanger between the districts hot and chilled water loops and those of the Building.

Parameters:

  • cooling_supply_temp – A number for the Building’s chilled water supply temperature in Celsius. (Default: 5C).

  • heating_supply_temp – A number for the Building’s hot water supply temperature in Celsius. This serves both space heating and service hot water demand. (Default: 50C).

  • exchanger_efficiency – A number between 0 and 1 for the heat exchanger efficiency. (Default: 0.8).

  • primary_pressure_drop – A number for the heat exchanger primary side pressure drop in pascals. (Default: 500).

  • secondary_pressure_drop – A number for the heat exchanger secondary side pressure drop in pascals. (Default: 500).

Properties:

  • cooling_supply_temp

  • heating_supply_temp

  • shw_supply_temp

  • exchanger_efficiency

  • primary_pressure_drop

  • secondary_pressure_drop

ToString()[source]

Overwrite .NET ToString method.

duplicate()[source]

Get a copy of this object.

classmethod from_dict(data)[source]

Create a HeatExchangerETS object from a dictionary

Parameters:

data – A dictionary representation of an HeatExchangerETS object in the format below.

{
'type': 'HeatExchangerETS',
'cooling_supply_temp': 5,  # float for building cooling temperature in C
'heating_supply_temp': 50,  # float for building heating temperature in C
'exchanger_efficiency': 0.8,  # float for heat exchanger efficiency
'primary_pressure_drop': 500,  # float for primary side pressure in Pa
'secondary_pressure_drop': 500  # float for secondary side pressure in Pa
}
lock()
to_des_param_dict()[source]

Get the HeatExchangerETS as it appears in a DES System Parameter dictionary.

to_dict()[source]

Get HeatExchangerETS dictionary.

unlock()
property cooling_supply_temp

Get or set the building’s chilled water supply temperature in C.

property exchanger_efficiency

Get or set a decimal number for the heat exchanger efficiency.

property heating_supply_temp

Get or set the building’s heating water supply temperature in C.

property primary_pressure_drop

Get or set a number for the heat exchanger primary side pressure drop in Pa.

property secondary_pressure_drop

Get or set a number for the heat exchanger secondary side pressure drop in Pa.

class dragonfly_energy.des.ets.HeatPumpETS(cooling_supply_temp=5, heating_supply_temp=50, shw_supply_temp=50, cop_cooling=3.5, cop_heating=2.5, cop_shw=2.5, pump_head=10000)[source]

Bases: object

Represents a Building Energy Transfer Station (ETS) within a fifth generation DES.

Parameters:

  • cooling_supply_temp – A number for the building’s chilled water supply temperature in Celsius. (Default: 5C).

  • heating_supply_temp – A number for the building’s heating water supply temperature in Celsius. (Default: 50C).

  • shw_supply_temp – A number for the building’s service hot water supply temperature in Celsius. (Default: 50C).

  • cop_cooling – A number for the coefficient of performance (COP) of the heat pump producing chilled water. (Default: 3.5).

  • cop_heating – A number for the coefficient of performance (COP) of the heat pump producing hot water for space heating. (Default: 2.5).

  • cop_shw – A number for the coefficient of performance (COP) of the heat pump producing service hot water. (Default: 2.5).

  • pump_head – A number for the design head pressure of the ETS pump in pascals. (Default: 10000).

Properties:

  • cooling_supply_temp

  • heating_supply_temp

  • shw_supply_temp

  • cop_cooling

  • cop_heating

  • cop_shw

  • pump_head

ToString()[source]

Overwrite .NET ToString method.

duplicate()[source]

Get a copy of this object.

classmethod from_dict(data)[source]

Create a HeatPumpETS object from a dictionary

Parameters:

data – A dictionary representation of an HeatPumpETS object in the format below.

{
'type': 'HeatPumpETS',
'cooling_supply_temp': 5,  # float for building cooling temperature in C
'heating_supply_temp': 40,  # float for building heating temperature in C
'shw_supply_temp': 50,  # float for building shw temperature in C
'cop_cooling': 3.5,  # float for cooling COP
'cop_heating': 3.0,  # float for heating COP
'cop_shw': 2.5,  # float for shw COP
'pump_head': 10000  # float for building-side pump pressure in Pa
}
lock()
to_des_param_dict()[source]

Get the HeatPumpETS as it appears in a DES System Parameter dictionary.

to_dict()[source]

Get HeatPumpETS dictionary.

unlock()
property cooling_supply_temp

Get or set the building’s chilled water supply temperature in C.

property cop_cooling

Get or set a number for the COP of the heat pump producing chilled water.

property cop_heating

Get or set a number for the COP of the heat pump producing heating water.

property cop_shw

Get or set a number for the COP of the heat pump producing service hot water.

property heating_supply_temp

Get or set the building’s heating water supply temperature in C.

property pump_head

Get or set a number for the design head pressure of the ETS pump in pascals.

property shw_supply_temp

Get or set the building’s service hot water supply temperature in C.