# ContextShade

![](/files/-MihrbvJiuyYLT8CCwqJ)

![](/files/-MihrbI43ErwBTXFM1AO) - [\[source code\]](https://github.com/ladybug-tools/dragonfly-grasshopper/blob/master/dragonfly_grasshopper/src//DF%20ContextShade.py)

Create Dragonfly ContextShade.

### Inputs

* **geo \[Required]**

Rhino Brep geometry.

* **name**

A name for the ContextShade. If the name is not provided a random name will be assigned.

* **ep\_constr**

Optional text for the ContextShade's energy construction to be looked up in the construction library. This can also be a custom construction object. If no energy construction is input here, a default will be assigned.

* **ep\_trans\_sch**

Optional text for the ContextShade's energy transmittance schedule to be looked up in the schedule library. This can also be a custom schedule object. If no energy schedule is input here, the default will be always opaque.

* **uwg\_is\_veg**

Boolean to note whether the shade represents a tree canopy within simulations with the Urban Weather Generator (UWG), in which case, it will be incorporated into the simulation as tree cover. NOTE that, when using this option, only the tops and sides of the tree canopy geometry should be modeled. Modeling the bottom of the tree canopy will result in double-counting the horizontal area of the canopy and will also create extra unnessary geometry in EnergyPlus or Radiance calculations using the dragonfly model. (Default: False).

### Outputs

* **report**

Reports, errors, warnings, etc.

* **context**

Dragonfly ContextShades.


---

# 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/dragonfly-primer/components/0_create/contextshade.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.