honeybee_energy.baseline.pci module

Module for computing Performance Cost Index (PCI) from baseline simulation results.

honeybee_energy.baseline.pci.comparison_from_sql(proposed_sql, baseline_sqls, climate_zone, building_type='NonResidential', electricity_cost=0.12, natural_gas_cost=0.06, district_cooling_cost=0.04, district_heating_cost=0.08, electricity_emissions=400)

Get a dictionary comparing baseline and proposed simulations from EnergyPlus SQLs.

Parameters:

• proposed_sql – The path of the SQL result file that has been generated from an energy simulation of a proposed building.

• baseline_sqls – The path of the SQL result file that has been generated from an energy simulation of a baseline building. This can also be a list of SQL result files (eg. for several simulations of different orientations) in which case the PCI will be computed as the average across all files. Lastly, it can be a directory or list of directories containing results, in which case, the target PCI will be calculated form all files ending in .sql.

• climate_zone – Text indicating the ASHRAE climate zone. This can be a single integer (in which case it is interpreted as A) or it can include the A, B, or C qualifier (eg. 3C).

• building_type –

  Text for the building type that the Model represents. This is used to determine the baseline window-to-wall ratio and HVAC system. If the type is not recognized or is “Unknown”, it will be assumed that the building is a generic NonResidential. The following have specified meaning per the standard.

  • NonResidential

  • Residential

  • MidriseApartment

  • HighriseApartment

  • LargeOffice

  • MediumOffice

  • SmallOffice

  • Retail

  • StripMall

  • PrimarySchool

  • SecondarySchool

  • SmallHotel

  • LargeHotel

  • Hospital

  • Outpatient

  • Warehouse

  • SuperMarket

  • FullServiceRestaurant

  • QuickServiceRestaurant

  • Laboratory

  • Courthouse

• electricity_cost – A number for the cost per each kWh of electricity. This can be in any currency as long as it is coordinated with the costs of other inputs to this method. (Default: 0.12 for the average 2020 cost of electricity in the US in $/kWh).

• natural_gas_cost – A number for the cost per each kWh of natural gas. This can be in any currency as long as it is coordinated with the other inputs to this method. (Default: 0.06 for the average 2020 cost of natural gas in the US in $/kWh).

• district_cooling_cost – A number for the cost per each kWh of district cooling energy. This can be in any currency as long as it is coordinated with the other inputs to this method. (Default: 0.04 assuming average 2020 US cost of electricity in $/kWh with a COP 3.5 chiller).

• district_heating_cost – A number for the cost per each kWh of district heating energy. This can be in any currency as long as it is coordinated with the other inputs to this method. (Default: 0.08 assuming average 2020 US cost of natural gas in $/kWh with an efficiency of 0.75 with all burner and distribution losses).

• electricity_emissions –

  A number for the electric grid carbon emissions in kg CO2 per MWh. For locations in the USA, this can be obtained from he honeybee_energy.result.emissions future_electricity_emissions method. For locations outside of the USA where specific data is unavailable, the following rules of thumb may be used as a guide. (Default: 400).

  • 800 kg/MWh - for an inefficient coal or oil-dominated grid

  • 400 kg/MWh - for the US (energy mixed) grid around 2020

  • 100-200 kg/MWh - for grids with majority renewable/nuclear composition

  • 0-100 kg/MWh - for grids with renewables and storage

Returns:

A dictionary with several keys.

• proposed_eui – A number for the proposed end use intensity. Specifically, this is the sum of all electricity, fuel, district heating/cooling, etc. divided by the gross floor area (including both conditioned and unconditioned spaces). Units are kWh/m2.

• proposed_energy – A number for the total energy use of the proposed building in kWh.

• proposed_cost – A number for the total annual energy cost of the proposed building.

• proposed_carbon – A number for the total annual operational carbon emissions of the proposed building in kg of C02.

• baseline_eui – A number for the baseline end use intensity. Specifically, this is the sum of all electricity, fuel, district heating/cooling, etc. divided by the gross floor area (including both conditioned and unconditioned spaces). Units are kWh/m2.

• baseline_energy – A number for the total energy use of the baseline building in kWh.

• baseline_cost – A number for the total annual energy cost of the baseline building.

• baseline_carbon – A number for the total annual operational carbon emissions of the baseline building in kg of C02.

• pci_t_2016 – A fractional number for the target PCI for ASHRAE 90.1-2016.

• pci_t_2019 – A fractional number for the target PCI for ASHRAE 90.1-2019.

• pci_t_2022 – A fractional number for the target PCI for ASHRAE 90.1-2022.

• pci – A fractional number for the PCI of the proposed building.

• pci_improvement_2016 – A number less than 100 for the percentage better that the proposed building is over the target PCI for ASHRAE 90.1-2016. Negative numbers indicate a proposed building that is worse than the 2016 target PCI.

• pci_improvement_2019 – A number less than 100 for the percentage better that the proposed building is over the target PCI for ASHRAE 90.1-2019. Negative numbers indicate a proposed building that is worse than the 2019 target PCI.

• pci_improvement_2022 – A number less than 100 for the percentage better that the proposed building is over the target PCI for ASHRAE 90.1-2022. Negative numbers indicate a proposed building that is worse than the 2022 target PCI.

• carbon_t_2016 – A fractional number for the target carbon index for ASHRAE 90.1-2016.

• carbon_t_2019 – A fractional number for the target carbon index for ASHRAE 90.1-2019.

• carbon_t_2022 – A fractional number for the target carbon index for ASHRAE 90.1-2022.

• pci_carbon – A fractional number for the performance improvement of the proposed building in terms of carbon emissions.

• carbon_improvement_2016 – A number less than 100 for the percentage better that the proposed building is over the target carbon for ASHRAE 90.1-2016. Negative numbers indicate a proposed building that is worse than the 2016 target.

• carbon_improvement_2019 – A number less than 100 for the percentage better that the proposed building is over the target carbon for ASHRAE 90.1-2019. Negative numbers indicate a proposed building that is worse than the 2019 target.

• carbon_improvement_2022 – A number less than 100 for the percentage better that the proposed building is over the target carbon for ASHRAE 90.1-2022. Negative numbers indicate a proposed building that is worse than the 2022 target.

honeybee_energy.baseline.pci.energy_cost_from_proposed_sql(sql_result, electricity_cost=0.12, natural_gas_cost=0.06, district_cooling_cost=0.04, district_heating_cost=0.08, electricity_emissions=400)

Get a dictionary of proposed energy cost from an EnergyPlus SQL.

Parameters:

• sql_result – The path of the SQL result file that has been generated from an energy simulation of a proposed building.

• electricity_cost – A number for the cost per each kWh of electricity. This can be in any currency as long as it is coordinated with the costs of other inputs to this method. (Default: 0.12 for the average 2020 cost of electricity in the US in $/kWh).

• natural_gas_cost – A number for the cost per each kWh of natural gas. This can be in any currency as long as it is coordinated with the other inputs to this method. (Default: 0.06 for the average 2020 cost of natural gas in the US in $/kWh).

• district_cooling_cost – A number for the cost per each kWh of district cooling energy. This can be in any currency as long as it is coordinated with the other inputs to this method. (Default: 0.04 assuming average 2020 US cost of electricity in $/kWh with a COP 3.5 chiller).

• district_heating_cost – A number for the cost per each kWh of district heating energy. This can be in any currency as long as it is coordinated with the other inputs to this method. (Default: 0.08 assuming average 2020 US cost of natural gas in $/kWh with an efficiency of 0.75 with all burner and distribution losses).

• electricity_emissions –

  A number for the electric grid carbon emissions in kg CO2 per MWh. For locations in the USA, this can be obtained from he honeybee_energy.result.emissions future_electricity_emissions method. For locations outside of the USA where specific data is unavailable, the following rules of thumb may be used as a guide. (Default: 400).

  • 800 kg/MWh - for an inefficient coal or oil-dominated grid

  • 400 kg/MWh - for the US (energy mixed) grid around 2020

  • 100-200 kg/MWh - for grids with majority renewable/nuclear composition

  • 0-100 kg/MWh - for grids with renewables and storage

Returns:

A dictionary with several keys.

• proposed_eui – A number for the total end use intensity. Specifically, this is the sum of all electricity, fuel, district heating/cooling, etc. divided by the gross floor area (including both conditioned and unconditioned spaces). Units are kWh/m2.

• proposed_energy – A number for the total energy use of the proposed building in kWh.

• proposed_cost – A number for the total annual energy cost of the proposed building.

• proposed_carbon – A number for the total annual operational carbon emissions of the proposed building in kg of C02.

honeybee_energy.baseline.pci.pci_target_from_baseline_sql(sql_results, climate_zone, building_type='NonResidential', electricity_cost=0.12, natural_gas_cost=0.06, district_cooling_cost=0.04, district_heating_cost=0.08, electricity_emissions=400)

Get a dictionary of target Performance Cost Indices from EnergyPlus SQLs.

Parameters:

• sql_results – The path of the SQL result file that has been generated from an energy simulation of a baseline building. This can also be a list of SQL result files (eg. for several simulations of different orientations) in which case the PCI will be computed as the average across all files. Lastly, it can be a directory or list of directories containing results, in which case, the target PCI will be calculated form all files ending in .sql.

• climate_zone – Text indicating the ASHRAE climate zone. This can be a single integer (in which case it is interpreted as A) or it can include the A, B, or C qualifier (eg. 3C).

• building_type –

  Text for the building type that the Model represents. This is used to determine the baseline window-to-wall ratio and HVAC system. If the type is not recognized or is “Unknown”, it will be assumed that the building is a generic NonResidential. The following have specified meaning per the standard.

  • NonResidential

  • Residential

  • MidriseApartment

  • HighriseApartment

  • LargeOffice

  • MediumOffice

  • SmallOffice

  • Retail

  • StripMall

  • PrimarySchool

  • SecondarySchool

  • SmallHotel

  • LargeHotel

  • Hospital

  • Outpatient

  • Warehouse

  • SuperMarket

  • FullServiceRestaurant

  • QuickServiceRestaurant

  • Laboratory

  • Courthouse

• electricity_cost – A number for the cost per each kWh of electricity. This can be in any currency as long as it is coordinated with the costs of other inputs to this method. (Default: 0.12 for the average 2020 cost of electricity in the US in $/kWh).

• natural_gas_cost – A number for the cost per each kWh of natural gas. This can be in any currency as long as it is coordinated with the other inputs to this method. (Default: 0.06 for the average 2020 cost of natural gas in the US in $/kWh).

• district_cooling_cost – A number for the cost per each kWh of district cooling energy. This can be in any currency as long as it is coordinated with the other inputs to this method. (Default: 0.04 assuming average 2020 US cost of electricity in $/kWh with a COP 3.5 chiller).

• district_heating_cost – A number for the cost per each kWh of district heating energy. This can be in any currency as long as it is coordinated with the other inputs to this method. (Default: 0.08 assuming average 2020 US cost of natural gas in $/kWh with an efficiency of 0.75 with all burner and distribution losses).

• electricity_emissions –

  A number for the electric grid carbon emissions in kg CO2 per MWh. For locations in the USA, this can be obtained from he honeybee_energy.result.emissions future_electricity_emissions method. For locations outside of the USA where specific data is unavailable, the following rules of thumb may be used as a guide. (Default: 400).

  • 800 kg/MWh - for an inefficient coal or oil-dominated grid

  • 400 kg/MWh - for the US (energy mixed) grid around 2020

  • 100-200 kg/MWh - for grids with majority renewable/nuclear composition

  • 0-100 kg/MWh - for grids with renewables and storage

Returns:

A dictionary with several keys.

• baseline_eui – A number for the total end use intensity. Specifically, this is the sum of all electricity, fuel, district heating/cooling, etc. divided by the gross floor area (including both conditioned and unconditioned spaces). Units are kWh/m2.

• baseline_energy – A number for the total energy use of the baseline building in kWh.

• baseline_cost – A number for the total annual energy cost of the baseline building.

• baseline_carbon – A number for the total annual operational carbon emissions of the baseline building in kg of C02.

• pci_t_2016 – A fractional number for the target PCI for ASHRAE 90.1-2016.

• pci_t_2019 – A fractional number for the target PCI for ASHRAE 90.1-2019.

• pci_t_2022 – A fractional number for the target PCI for ASHRAE 90.1-2022.

• carbon_t_2016 – A fractional number for the target carbon index for ASHRAE 90.1-2016.

• carbon_t_2019 – A fractional number for the target carbon index for ASHRAE 90.1-2019.

• carbon_t_2022 – A fractional number for the target carbon index for ASHRAE 90.1-2022.