# Sensor Grid from Apertures

![](/files/JNgYNAvnOtagsy5ugOIu)

![](/files/CzWPFipYzp5E5p4ePINB) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-radiance/blob/master/honeybee_grasshopper_radiance/src//HB%20Sensor%20Grid%20from%20Apertures.py)

Generate SensorGrid objects from exterior Apertures.

These SensorGrids can be used in any grid-based recipe and are particularly useful for irradiance studies that evaluate solar gain of buildings, such as peak solar irradiance studies.

### Inputs

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

A list of honeybee Faces or Rooms for which sensor grids will be generated. This can also be an entire Honeybee Model.

* **grid\_size \[Required]**

Number for the size of the grid cells.

* **offset**

Number for the distance to move points from the base geometry. Positive numbers indicate an offset towards the exterior while negative numbers indicate an offset towards the interior, essentially modeling the value of trasnmitted sun through the glass. The default is 0.1 meters.

* **ap\_type**

Text or an integer to specify the type of aperture that will be used to generate grids. Choose from the following. (Default: All).

```
* 1 - Window

* 2 - Skylight

* 3 - All
```

* **quad\_only**

Boolean to note whether meshing should be done using Rhino's defaults (False), which fills the entire aperture geometry to the edges with both quad and tringulated faces, or a mesh with only quad faces should be generated. (Default: False).

### Outputs

* **grid**

A SensorGrid object that can be used in a grid-based recipe.

* **points**

The points that are at the center of each grid cell.

* **mesh**

Analysis mesh that can be passed to the 'Spatial Heatmap' component.


---

# 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-radiance-primer/components/0_basicproperties/sensor_grid_from_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.