honeybee_energy.result.emissions module

Module for converting EnergyPlus results into operational carbon emissions.

honeybee_energy.result.emissions.emissions_from_sql(sql_results, electricity_emissions)[source]

Get a dictionary of Carbon Emissions Intensity results from EnergyPlus SQLs.

This input emissions of electricity will be used to compute carbon intensity for both electricity and district heating/cooling. Fixed numbers will be used to convert the following on-site fuel sources:

  • Natural Gas – 277.358 kg/MWh

  • Propane – 323.897 kg/MWh

  • Fuel Oil – 294.962 kg/MWh

  • District Heating – 369.811 kg/MWh

  • District Cooling – [electricity_emissions] / 3.5 kg/MWh

Parameters

  • sql_results – The file path of the SQL result file that has been generated from an energy simulation. This can also be a list of SQL result files in which case EUI will be computed across all files. Lastly, it can be a directory or list of directories containing results, in which case, EUI will be calculated form all files ending in .sql.

  • 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 the 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:

    • 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.

  • carbon_intensity – A number for the total annual carbon intensity. This is the sum of all operational carbon emissions divided by the gross floor area (including both conditioned and unconditioned spaces). Units are kg CO2/m2.

  • total_floor_area – A number for the gross floor area of the building in m2. This excludes Rooms with True exclude_floor_area property.

  • conditioned_floor_area – A number for the conditioned floor area of the building in m2. This excludes Rooms with True exclude_floor_area property.

  • total_carbon – A number for the total annual operational carbon in kg of Co2.

  • end_uses – A dictionary with the carbon intensity for each of the end uses of the building (eg. heating, cooling, lighting, etc.).

  • sources – A dictionary with the carbon intensity for each of the energy sources of the building (eg. electricity, natural_gas, district_heat, etc.).

honeybee_energy.result.emissions.emissions_region(location)[source]

Get the region of carbon emissions associated with a location.

Parameters

location – A ladybug Location object, which will be used to determine the subregion.

Returns

A Tuple of text for the eGrid subregion for the location. The first value is the future emissions region, the second is the historical region, and the last is the historic hourly region. This will be None if the location cannot be mapped to a region.

honeybee_energy.result.emissions.future_electricity_emissions(location, year=2030)[source]

Get the future carbon emissions of the electric grid associated with a location.

Parameters

  • location – A ladybug Location object, which will be used to determine the subregion.

  • year – An integer for the future year for which carbon emissions will be estimated. Values must be an even number and be between 2020 and 2050. (Default: 2030).

Returns

A number for the electric grid carbon emissions in kg CO2 per MWh.