# Search Programs

![](/files/-MihpeqwOG76MXd359sH)

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

Search for available ProgramTypes within the honeybee energy standards library.

Note that the Room ProgramTypes output from this component effectively map to space types within OpenStudio.

## Inputs

* **bldg\_prog**

  Text for the building program to search (eg. "LargeOffice", "MidriseApartment", etc.). The Honeybee "Building Programs" component lists all of the building programs available in the library. If None, all ProgramTypes within the library will be output (filtered by keywords\_ below). 
* **vintage**

  Text for the building vintage to search (eg. "2019", "pre\_1980", etc.). The Honeybee "Building Vintages" component lists all of the vintages available in the library. Default: "2019" (for ASHRAE 90.1 2019 | IECC 2015). Note that vintages are often called "templates" within the OpenStudio standards gem and so this property effective maps to the standards gem "template". 
* **keywords**

  Optional keywords to be used to narrow down the output list of room programs. If nothing is input here, all available room programs will be output. 

## Outputs

* **room\_prog**

  A list of room program identifiers that meet the input criteria and can be applied to Honeybee Rooms. 


---

# 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/0_basicproperties/search_programs.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.