# Louver Shades

![](https://3521261292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPHXQ1FZ8W_xSW4Nb61%2Fuploads%2Fgit-blob-785af1d8d7673ca0b5cf87764010ff9a44e52fcd%2FLouver_Shades.png?alt=media)

![](https://3521261292-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LPHXQ1FZ8W_xSW4Nb61%2Fuploads%2Fgit-blob-7e162e85f110e9d3e8344de350da3f4d4c93b802%2FLouver_Shades.png?alt=media) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-core/blob/master/honeybee_grasshopper_core/src/HB%20Louver%20Shades.py)

Add louverd Shades, overhangs or fins to all the outdoor Apertures of an input Room, Face or Aperture.

Note that, if a Face or Room is input, Shades will only be added to those Faces that are Walls (not Floors or Roofs).

### Inputs

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

A list of honeybee Rooms, Faces, or Apertures to which louver shades will be added.

* **depth \[Required]**

A number for the depth to extrude the louvers. If an array of values are input here, different depths will be assigned based on cardinal direction, starting with north and moving clockwise.

* **shade\_count**

A positive integer for the number of louvers to generate. If there is an input below for *dist\_between*, an attempt will still be made to meet the *shade\_count* but, if there are more shades than can fit on the input hb\_obj, the number of shades will be truncated. If an array of values are input here, different shade counts will be assigned based on cardinal direction, starting with north and moving clockwise. (Default: 1).

* **dist\_between**

A number for the approximate distance between each louver. If an array of values are input here, different distances between louvers will be assigned based on cardinal direction, starting with north and moving clockwise.

* **facade\_offset**

A number for the distance from the louver edge to the facade. If an array of values are input here, different offsets will be assigned based on cardinal direction, starting with north and moving clockwise. (Default: 0).

* **angle**

A number for the for an angle to rotate the louvers in degrees. If an array of values are input here, different angles will be assigned based on cardinal direction, starting with north and moving clockwise. (Default: 0).

* **vertical**

Optional boolean to note whether the lovers are vertical. If False, the louvers will be horizontal. If an array of values are input here, different vertical booleans will be assigned based on cardinal direction, starting with north and moving clockwise. (Default: False).

* **flip\_start**

Optional boolean to note whether the side the louvers start from should be flipped. If False, louvers will be generated starting on top or the right side. If True, louvers will start from the bottom or left. If an array of values are input here, different flip start booleans will be assigned based on cardinal direction, starting with north and moving clockwise. Default: False.

* **indoor**

Optional boolean for whether louvers should be generated facing the opposite direction of the aperture normal and added to the Aperture's indoor\_shades instead of outdoor\_shades. If an array of values are input here, different indoor booleans will be assigned based on cardinal direction, starting with north and moving clockwise. Note that, by default, indoor shades are not used in energy simulations but they are used in all simulations involving Radiance. (Default: False).

* **ep\_constr**

Optional Honeybee ShadeConstruction to be applied to the input \_hb\_objs. This can also be text for a construction to be looked up in the shade construction library. If an array of text or construction objects are input here, different constructions will be assigned based on cardinal direction, starting with north and moving clockwise.

* **ep\_trans\_sch**

Optional schedule for the transmittance to be applied to the input \_hb\_objs in energy simulation. If no energy schedule is input here, the default will be always opaque.

* **rad\_mod**

Optional Honeybee Modifier to be applied to the input \_hb\_objs. This can also be text for a modifier to be looked up in the shade modifier library. If an array of text or modifier objects are input here, different modifiers will be assigned based on cardinal direction, starting with north and moving clockwise.

### Outputs

* **report**

Reports, errors, warnings, etc.

* **hb\_objs**

The input Honeybee Face or Room or Aperture with louvered shades added to it.