# Sensor Grid from Faces

![](/files/McOaLRu5u9tjyo0NyQqm)

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

Generate SensorGrid objects from exterior Faces (Walls, Roofs, and Floors).

These SensorGrids can be used in any grid-based recipe and are particularly useful for radiation studies of roofs for photovoltaic potential or solar gain studies of walls.

### 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. The default is 0.1 meters.

* **face\_type**

Text or an integer to specify the type of face that will be used to generate grids. Note that only Faces with Outdoors boundary conditions will be used, meaning that most Floors will typically be excluded unless they represent the underside of a cantilever. Choose from the following. (Default: Wall).

```
* 1 - Wall

* 2 - Roof

* 3 - Floor

* 4 - All
```

* **punched**

Boolean to note whether the punched\_geometry of the faces should be used (True) with the areas of sub-faces removed from the grid or the full geometry should be used (False). (Default:False).

* **quad\_only**

Boolean to note whether meshing should be done using Rhino's defaults (False), which fills the entire face 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_faces.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.