honeybee_energy.result.eui module

Module to parse End Use Intensity (EUI) from EnergyPlus results.

honeybee_energy.result.eui.eui_from_sql(sql_results, absolute=False)[source]

Get a dictionary of End Use Intensity (EUI) results from EnergyPlus SQLs.

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.

  • absolute – A boolean to note whether the output values are in absolute kWh of energy use (True) instead of energy use intensity in kWh/m2 (False). Setting this to “True” can be useful when the model contains no floor area for which an intensity metric can be computed but there is still energy use to be evaluated. (Default: False).

Returns:

A dictionary with several keys.

  • 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 unless absolute is True in which case units are kWh.

  • 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_energy – A number for the total energy use of the building in kWh.

  • end_uses – A dictionary with the end use intensity for each of the end uses of the building (eg. heating, cooling, lighting, etc.). Units are kWh/m2 unless absolute is True in which case units are kWh.