Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

00 | Honeybee
01 | Daylight | Material
02 | Daylight | Light Source
03 | Daylight | Recipes
04 | Daylight | Daylight
05 | Energy | Building Program
06 | Energy | Material | Construction
07 | Energy | Schedule
08 | Energy | Set Zone Properties
09 | Energy | HVACSystems
10 | Energy | Energy
11 | THERM
12 | Developers
13 | WIP

Use this component to generate windows for a HBSurface or HBZone based on a desired window-to-wall ratio. In addition to generating window geometry that corresponds with the input ratio, this component also allows you a fairly high level of control over the window geometry.
The first way in which you gain additional control over geometry is the option of whether you want to generate a single window for each surface, which is good for making energy simulations run fast, or you want to use the glazig ratio to create several windows distributed across the surfaces, which is often necessary to have accurate daylight simulations or high-resolution thermal maps.
If you break up the window into several ones, you also have the ability to set the distance between each of the windows along the surface.
If you input wall surfaces that have perfectly horizontal tops and/or bottoms, you also have access to a number of other other inputs such as window height, the sill height, and whether you want to split the glazing vertically into two windows.

Inputs

NameIDDescriptionType
HBObjects_HBObjectsHoneybee thermal zones or surfaces for which glazing should be generated.Goo
Glz Ratio_glzRatioThe fraction of the wall surface that should be glazed. This input only accepts values between 0 and 0.95 (we don't go all of the way up to 1 because EnergyPlus does not like this). This input can also accept lists of values and will assign different glazing ratios based on cardinal direction, starting with north and moving counter-clockwise. Note that glazing ratio always takes priority over the windowHeight and sillHeight inputs below.Goo
Break Up WindowbreakUpWindow_Set to "True" to generate a distributed set of multiple windows on walls and set to "False" to generate just a single window per rectangular wall surface. This input can also accept lists of boolean values and will assign different 'BreakUpWindow' values based on cardinal direction, starting with north and moving counter-clockwise. A single window for each surface is good for making energy simulations run fast while several distributed windows is often necessary to have accurate daylight simulations or high-resolution thermal maps. The default is set to "True" to generate multiple distributed windows.Goo
Break Up DistbreakUpDist_An optional number in Rhino model units that sets the distance between individual windows on rectangular surfaces when the breakUpWindow_ input above is set to 'True'. This input can also accept lists of values and will assign different sill heights based on cardinal direction, starting with north and moving counter-clockwise. Note that this input will be over-ridden at high glazing ratios or window heights. The default is set to 2 meters.Goo
Window HeightwindowHeight_An optional number in Rhino model units that sets the height of your windows on rectangular surfaces when the breakUpWindow_ input above is set to 'True'. This input can also accept lists of values and will assign different window heights based on cardinal direction, starting with north and moving counter-clockwise. Note that this input will be over-ridden at high glazing ratios. The default is set to 2 meters.Goo
Sill HeightsillHeight_An optional number in Rhino model units that sets the distance from the floor to the bottom of your windows on rectangular surfaces when the breakUpWindow_ input above is set to 'True'. This input can also accept lists of values and will assign different sill heights based on cardinal direction, starting with north and moving counter-clockwise. Note that this input will be over-ridden at high glazing ratios or window heights. The default is set to 0.8 meters (or 80 centimeters).Goo
Split Glz Vert DistsplitGlzVertDist_An optional number in Rhino model units that splits the windows on rectangular surfaces into two with a vertical distance between them equal to this input when the breakUpWindow_ input above is set to 'True'. This input can also accept lists of values and will assign different vertical distances based on cardinal direction, starting with north and moving counter-clockwise. Note that this input will be over-ridden at high glazing ratios, high window heights, or high sill heights.Goo
EPConstructionsEPConstructions_A optional text string of an EnergyPlus construction name that sets the material construction of the window. This input can also accept lists of values and will assign different EPconstructions based on cardinal direction, starting with north and moving counter-clockwise. The default will assign a generic double pane window without low-e coatings.Goo
RADMaterialsRADMaterials_A optional text string of an Radiance glass material name that sets the material of the window. This input can also accept lists of values and will assign different RadMaterials based on cardinal direction, starting with north and moving counter-clockwise.Goo
Run It_runItset runIt to True to generate the glazingGoo

Outputs

NameIDDescriptionType
OutreadMe!...String
HBObj WGLZHBObjWGLZNewhoneybee zones that contain glazing surfaces based on the parameters above. Goo

Video Tutorials

Site design © Robin Rodricks.   Co-created by Andrew Heumann.   Honeybee and associated data © 2020 Mostapha Sadeghipour Roudsari.  
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.  Hosted by GitHub

Report an Issue  |  Terms of Service