# Thermal Load Balance

![](/files/-Mihpg4ippMnbV7c3ZMx)

![](/files/-Mihpg4kOZ9lULMiFdz3) - [\[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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ladybug.tools/hb-energy-primer/components/6_result/thermal_load_balance.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.