# Window Construction Shade

![](https://459479801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma9N5K8lMbAhbyBVgms%2Fuploads%2Fgit-blob-deb7949469a2771a2eee9c4908117d4fd871acc5%2FWindow_Construction_Shade.png?alt=media)

![](https://459479801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma9N5K8lMbAhbyBVgms%2Fuploads%2Fgit-blob-91a060855c0f92b629f1d1e4e5f6f7b038c0d33c%2FWindow_Construction_Shade.png?alt=media) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-energy/blob/master/honeybee_grasshopper_energy/src/HB%20Window%20Construction%20Shade.py)

Create an EnergyPlus window construction that includes shades/blinds or a dynamically- controlled glass pane.

The result can be assigned to any Aperture or ConstructionSet just like any other WindowConstruction.

### Inputs

* **name**

Text to set the name for the Construction and to be incorporated into a unique Construction identifier.

* **win\_constr \[Required]**

A WindowConstruction object that serves as the "switched off" version of the construction (aka. the "bare construction"). The shade material and shade location will be used to modify this starting construction. This can also be text for a construction identifier to be looked up in the window construction library.

* **shd\_material \[Required]**

An Shade Material or an Blind Material that serves as the shading layer for this construction. This can also be a Glass Material, which will indicate that the WindowConstruction has a dynamically- controlled glass pane like an electrochromic window assembly. This can also be text for a material identifier to be looked up in the window material library.

* **shd\_location**

Text to indicate where in the window assembly the shade material is located. (Default: "Interior"). Choose from the following 3 options:

```
* Interior

* Between

* ExteriorNote that the WindowConstruction must have at least one gas gap to use the "Between" option. Also note that, for a WindowConstruction with more than one gas gap, the "Between" option defalts to using the inner gap as this is the only option that EnergyPlus supports. 
```

* **control\_type**

An integer or text to indicate how the shading device is controlled, which determines when the shading is “on” or “off.” (Default: "AlwaysOn"). Choose from the options below (units for the values of the corresponding setpoint are noted in parentheses next to each option): 0 = AlwaysOn 1 = OnIfHighSolarOnWindow (W/m2) 2 = OnIfHighHorizontalSolar (W/m2) 3 = OnIfHighOutdoorAirTemperature (C) 4 = OnIfHighZoneAirTemperature (C) 5 = OnIfHighZoneCooling (W) 6 = OnNightIfLowOutdoorTempAndOffDay (C) 7 = OnNightIfLowInsideTempAndOffDay (C) 8 = OnNightIfHeatingAndOffDay (W)

* **setpoint**

A number that corresponds to the specified control\_type. This can be a value in (W/m2), (C) or (W) depending upon the control type.

* **schedule**

An optional ScheduleRuleset or ScheduleFixedInterval to be applied on top of the control type. If specified, the window will only be switched on when both the schedule value is > 0 and and control\_type criteria are met. Otherwise, the shade is off. If a schedule is unspecified, the control type will govern all behavior of the construction.

### Outputs

* **constr**

A shaded window construction that can be assigned to Honeybee Apertures or ConstructionSets.


---

# 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-energy-primer/components/1_constructions/window_construction_shade.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.