# Simplify Apertures

![](/files/gjxwylweX8H8WCvY0twh)

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

Simplify the Apertures assigned to Honeybee Rooms or Faces to be as few as possible while still maintaining approximately the same overall Aperture area.

By default, this component will only simplify Apertures in convex Faces by reducing them to a ratio represented with one or two clean Apertures. For models without many concave Faces, this process usually produces a fast-simulating result that matches the original window area exactly. However, this operation will also change the placement of Apertures within a Face, which may make it unsuitable for modeling the impact of Shades on Apertures or for evaluating daylight.

For cases with concave Faces (which is typical for Roofs/Skylights) or when it is desirable to keep Apertures in the same location within the parent Face, the Apertures can be simplified by specifying a merge\_dist\_, which will join together Apertures in close proximity to one another rather than reducing them to a ratio.

### Inputs

* **hb\_objs \[Required]**

A list of honeybee Rooms or Faces to which Apertures will be simplified. This can also be an entire honeybee Model for which all Rooms will have Apertures simplified.

* **merge\_dist**

Distance between Apertures and/or Doors at which point they will be merged into a single Aperture. When unspecified, only Apertures within convex faces will be reduced to a ratio. This will match the original Aperture area exactly but it will change the placement of Apertures within the Face, which can make it unsuitable for modeling the impact of Shades on Apertures. When a value is specified here, concave Faces will be addressed and Apertures will remain where they are in the parent Face. The overall Aperture area may be a little larger thanks to merging across gaps that are less than or equal to the value specified but the result will be suitable for evaluating the impact of Shades or simulating daylight.

* **del\_interior**

Boolean to note whether the simplification process should remove all interior Apertures with a Surface boundary condition (True) or an attempt will be made to reset adjacencies after Apertures have been simplified/rebuilt (False). (Default: False).

* **ignore\_skylights**

Boolean to note whether the simplification process should ignore all skylights and leave them as they are. (Default: False).

* **ignore\_windows**

Boolean to note whether the simplification process should ignore all windows and leave them as they are. (Default: False).

### Outputs

* **report**

Reports, errors, warnings, etc.

* **hb\_objs**

The input Honeybee Face, Room or Model with Apertures simplified.


---

# 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/simplify_apertures.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.