# Thermal Load Balance

![](https://459479801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma9N5K8lMbAhbyBVgms%2Fuploads%2Fgit-blob-f5bfdf658ece9b0d975b8fd934852b9534e13abe%2FThermal_Load_Balance.png?alt=media)

![](https://459479801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma9N5K8lMbAhbyBVgms%2Fuploads%2Fgit-blob-b1cfc95af8744a7be54a08a7584ec167d81d1b89%2FThermal_Load_Balance.png?alt=media) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-energy/blob/master/honeybee_grasshopper_energy/src/HB%20Thermal%20Load%20Balance.py)

Construct a complete thermal load balance from energy simulation results and honeybee Rooms or a Model.

### Inputs

* **rooms\_model \[Required]**

An array of honeybee Rooms or a honeybee Model for which the thermal load balance will be computed. In most cases, these should be the Rooms or Model that are fed directly into the simulation. But this can also be a subset of such Rooms and the balance will only be computed for those Rooms.

* **cooling**

Array of data collections for 'Zone Ideal Loads Supply Air Cooling Energy'.

* **heating**

Array of data collections for 'Zone Ideal Loads Supply Air Heating Energy'.

* **lighting**

Array of data collections for 'Zone Lights Heating Energy'.

* **electric\_equip**

Array of data collections for 'Zone Electric Equipment Heating Energy'.

* **gas\_equip**

Array of data collections for 'Zone Gas Equipment Heating Energy'.

* **process**

Array of data collections for 'Zone Other Equipment Total Heating Energy'.

* **hot\_water**

Array of data collections for 'Water Use Equipment Zone Heat Gain Energy' that correspond to the input rooms.

* **people\_gain**

Array of data collections for 'Zone People Heating Energy'.

* **solar\_gain**

Array of data collections for 'Zone Windows Transmitted Solar Radiation Energy'.

* **infiltration\_load**

An array of data collections for the infiltration heat loss (negative) or heat gain (positive).

* **mech\_vent\_load**

An array of data collections for the ventilation heat loss (negative) or heat gain (positive) as a result of meeting minimum outdoor air requirements with the mechanical system.

* **nat\_vent\_load**

An array of data collections for the natural ventilation heat loss (negative) or heat gain (positive).

* **face\_energy\_flow**

An array of data collections for the surface heat loss (negative) or heat gain (positive).

* **detailed\_faces**

Boolean to note whether the opaque conduction losses should be broken down into walls, roofs, and floors. Setting this to True will also cause storage to be broken down into storage in walls, floors, windows, and air. (Default: False).

### Outputs

* **report**

...

* **balance**

A list of data collections where each collection represents a load balance term. This can then be plugged into the "LB Hourly Plot" or "LB Monthly Chart" to give a visualization of the load balance over all connected Rooms.

* **balance\_stor**

The balance output plus an additional term to represent the remainder of the load balance. This term is labeled "Storage" since it typically represents the energy being stored in the building's mass. If this term is particularly large, it can indicate that not all of the load balance terms have been plugged into this component.

* **norm\_bal**

A list of data collections where each collection represents a load balance term that has bee normalized by the Room floor area. This can then be plugged into the "LB Hourly Plot" or "LB Monthly Chart" to give a visualization of the load balance over all connected Rooms.

* **norm\_bal\_stor**

The norm\_bal output plus an additional term to represent the remainder of the load balance. This term is labeled "Storage" since it typically represents the energy being stored in the building's mass. If this term is particularly large, it can indicate that not all of the load balance terms have been plugged into this component.
