# Radial Grid from Rooms

![](https://2572426507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma9X8PomX22wWVDNCoj%2Fuploads%2Fgit-blob-81dfff2bb592b2d2e6f302e03fcb119d1461036c%2FRadial_Grid_from_Rooms.png?alt=media)

![](https://2572426507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma9X8PomX22wWVDNCoj%2Fuploads%2Fgit-blob-56b60695ded8b3340d66447a7c1a8b13b2d84c63%2FRadial_Grid_from_Rooms.png?alt=media) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-radiance/blob/master/honeybee_grasshopper_radiance/src/HB%20Radial%20Grid%20from%20Rooms.py)

Generate SensorGrids of radial directions around positions from the floors of rooms.

This type of sensor grid is particularly helpful for studies of multiple view directions, such as imageless glare studies.

The names of the grids will be the same as the rooms that they came from.

### Inputs

* **rooms \[Required]**

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

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

Number for the size of the grid cells.

* **dist\_floor**

Number for the distance to move points from the floors of the input rooms. (Default: 1.2 meters).

* **dir\_count**

A positive integer for the number of radial directions to be generated around each position. (Default: 8).

* **start\_vec**

A Vector3D to set the start direction of the generated directions. This can be used to orient the resulting sensors to specific parts of the scene. It can also change the elevation of the resulting directions since this start vector will always be rotated in the XY plane to generate the resulting directions. (Default: (0, -1, 0)).

* **wall\_offset**

A number for the distance at which sensors close to walls should be removed.

* **by\_zone**

Set to "True" to have the component generate one sensor grid per zone across the input rooms rather than one sensor grid per room. This option is useful for getting a more consolidated set of Radiance results by zone. (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 circle. These align with the vecs output below and can be visualized with the native Grasshopper vector display component.

* **vecs**

The vectors for the directions of each sensor. These align with the points output above and can be visualized with the native Grasshopper vector display component.

* **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/radial_grid_from_rooms.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.