# Apply Setpoint Values

![](/files/-MihpfV6rc_AiV22ZdmB)

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

Apply values for setpoints to a Room or ProgramType.

### Inputs

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

Honeybee Rooms or ProgramType objects to which the input setpoints 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 setpoints.

* **cooling\_setpt**

A numerical value for a single constant temperature for the cooling setpoint \[C].

* **heating\_setpt**

A numerical value for a single constant temperature for the heating setpoint \[C].

* **humid\_setpt**

A numerical value for a single constant value for the humidifying setpoint \[%].

* **dehumid\_setpt**

A numerical value for a single constant value for the dehumidifying setpoint \[%].

* **cutout\_difference**

An optional positive number for the temperature difference between the cutout temperature and the setpoint temperature. Specifying a non-zero number here is useful for modeling the throttling range associated with a given setup of setpoint controls and HVAC equipment. Throttling ranges describe the range where a zone is slightly over-cooled or over-heated beyond the thermostat setpoint. They are used to avoid situations where HVAC systems turn on only to turn off a few minutes later, thereby wearing out the parts of mechanical systems faster. They can have a minor impact on energy consumption and can often have significant impacts on occupant thermal comfort, though using the default value of zero will often yield results that are close enough when trying to estimate the annual heating/cooling energy use. Specifying a value of zero effectively assumes that the system will turn on whenever conditions are outside the setpoint range and will cut out as soon as the setpoint is reached. (Default: 0).

### Outputs

* **report**

Reports, errors, warnings, etc.

* **mod\_obj**

The input Rooms or ProgramTypes with their setpoint values edited.


---

# 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_setpoint_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.