# Automatic Zoning

![](/files/9Ge9t5DFwdmLOSiW4F9s)

![](/files/MYv4cbYaUaatNttdD8Fo) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-core/blob/master/honeybee_grasshopper_core/src//HB%20Automatic%20Zoning.py)

Automatically group rooms with similar properties and use the groups to assign zones.

Relevant properties that are used to group Room2Ds into zones include story, orientation, and (optionally) energy programs.

Rooms that share the same zone have a common thermostat in energy simulation. This can often significnatly reduce simulation time without greatly impacting energy use results.

### Inputs

* **rooms \[Required]**

A list of honeybee honeybee Rooms to which zones will be assigned. This can also be an entire Honeybee Model. Note that these rooms should have adjacencies solved in order for them to be correctly zoned based on orientation.

* **orient\_count**

A positive integer to set the number of orientation groups to use for zoning. For example, setting this to 4 will result in zones being established based on the four orientations (North, East, South, West). (Default: 8).

* **north**

A number between 0 and 360 to set the clockwise north direction in degrees. This can also be a vector to set the North. Default is 0 for the world Y-axis.

* **ignore\_programs**

Boolean for whether the Programs assigned to the Rooms should be ignored during the automatic zoning process in which case rooms with different programs can appear in the same zone. (Default: False).

### Outputs

* **report**

Errors, warnings, etc.

* **rooms**

The input Rooms (or Model) with zones assigned based on the input criteria.


---

# 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/honeybee-primer/components/0_create/automatic_zoning.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.