# Apply Load Values

![](/files/-MihpeRTgMYCOIDrkRQh)

![](/files/-MihpeMbYCO8U3DHkabm) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-energy/blob/master/honeybee_grasshopper_energy/src//HB%20Apply%20Load%20Values.py)

Apply or edit load values on a Room or ProgramType.

This component will not edit any of the schedule objects associated with each load value. If no schedule currently exists to describe how the load varies over the simulation, the "Always On" schedule will be used as a default.

### Inputs

* **room\_or\_program \[Required]**

Honeybee Rooms or ProgramType objects to which the input load objects should be assigned. This can also be the identifier of a ProgramType to be looked up in the program type library. This can also be a Honeybee Model for which all Rooms will be assigned the loads.

* **people\_per\_floor**

A numerical value for the number of people per square meter of floor area.

* **lighting\_per\_floor**

A numerical value for the lighting power density in Watts per square meter of floor area.

* **electric\_per\_floor**

A numerical value for the electric equipment power density in Watts per square meter of floor area.

* **gas\_per\_floor**

A numerical value for the gas equipment power density in Watts per square meter of floor area.

* **hot\_wtr\_per\_floor**

A numerical value for the total volume flow rate of water per unit area of floor in (L/h-m2).

* **infilt\_per\_exterior**

A numerical value for the intensity of infiltration in m3/s per square meter of exterior surface area. Typical values for this property are as follows (note all values are at typical building pressures of \~4 Pa):

```
* 0.0001 (m3/s per m2 facade) - Tight building

* 0.0003 (m3/s per m2 facade) - Average building

* 0.0006 (m3/s per m2 facade) - Leaky building
```

* **vent\_per\_floor**

A numerical value for the intensity of outdoor air ventilation in m3/s per square meter of floor area. This will be added to the vent\_per\_person\_ and vent\_ach\_ to produce the final minimum outdoor air specification.

* **vent\_per\_person**

A numerical value for the intensity of outdoor air ventilation in m3/s per person. This will be added to the vent\_per\_floor\_, and vent\_ach\_ to produce the final minimum outdoor air specification. Note that setting this value does not mean that ventilation is varied based on real-time occupancy but rather that the minimum level of ventilation is determined using this value and the People object of the zone. To vary ventilation on a timestep basis, a ventilation schedule should be used or the dcv\_ option should be selected on the HVAC system if it is available.

* **vent\_ach**

A numerical value for the intensity of outdoor air ventilation in air changes er hour (ACH). This will be added to the vent\_per\_floor\_ and vent\_per\_person\_ to produce the final minimum outdoor air specification.

### Outputs

* **report**

Reports, errors, warnings, etc.

* **mod\_obj**

The input Rooms or ProgramTypes with their load values modified.


---

# 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/3_loads/apply_load_values.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.