Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

0 | Ladybug
1 | AnalyzeWeatherData
2 | VisualizeWeatherData
3 | EnvironmentalAnalysis
4 | Renewables
5 | Extra
6 | Developers
7 | WIP

Use this component to adjust the assumptions of the passive strategies that can be overalid on the Ladybug the Psychrometric Chart. The default assumptions of each of the strategies are as follows:
Evaporative Cooling - This polygon represents the conditions under which direct evaporative cooling would be helpful. As such, it takes as its upper limit the line of constant enthalpy from the edge of the comfort polygon and includes all warm temperatures below it. If the user has set a minimum humidity tolerance, the polygon will also include the points beneath the comfort polygon as it is assumed that the evaporation of water will both humidify and cool the air. Nothe that this direct evaporative cooling polygon is slightly different than 2-stage evaporative cooling.
Thermal Mass + Night Flush - The polygon represents the conditions under which shaded, night-flushed thermal mass can keep occupants cool. By default, this polygon assumes that temperatures can get as high as 16.7 C above the max temperature of the comfort polygon as long temperatures 12 hours before the hot period are 2.8 C lower than the max temperture of the comfort polygon. This parameter component can be used to adjust these two numbers. The thermal mass polygon is limited in terms of humidity in that it obeys any limits on absolute humidity that the comfort polygon dies.
Occupant Use of Fans - This polygon is made by assuming that a wind speed of 1.5 m/s is the maximum speed tolerable before it starts blowing papers and becomes annoying to occupants. This strategy parameters component can be used to adjust this maximum acceptable wind speed. As such, the polygon is determined by running a PMV model with this wind speed and the input rad temp, met rate and clo level of the psych chart. This component obeys any limits on humidity that the comfort polygon does. Note that this polygon assumes that you are already naturally ventilating and that your natural ventilation period is defined by your comfort polygon.
Internal Heat Gain - The component assumes a minimum building balance point of 12.8 C and any conditions that are warmer than that (up to the comfort polygon) will keep occupants comfortable. It is assumed that, above this outdoor temperature, the building is free-running and occupants are able to open windows as they wish. Note that this balance temperature of 12.8 is fairly low and assumes a large number of inside heat sources or people as well as in insulated envelope. This balance temperature can be adjusted with this strategyPar component.
Dessicant Dehumidification - This polygon represents the conditions under which dessicant dehumidification would be helpful. As such, it takes as its upper limit the line of constant enthalpy from the edge of the comfort polygon and includes all humid conditions below it. Note that this polygon does not appear if there is no upper humidity limit on the comfort polygon.

Inputs

NameIDDescriptionType
Max Temp Above ComfmaxTempAboveComf_An optional number in degrees C representing the maximum daily temperature above the comfort range which can still be counted in the Thermal Mass + Night Flush polygon. The default is set to 12 C above the highest comfort temperature.Goo
Min Night Diff Below ComfminNightDiffBelowComf_An optional number in degrees C representing the minimum temperature below the maximum comfort temperature that the outdoor temperature must drop at night in order to count towards the Thermal Mass + Night Flush polygon. The default is set to 3 C.Goo
Max Comfortable Air SpeedmaxComfortableAirSpeed_An optional number in m/s that represents the maximum winds speed tolerable before becomes annoying to occupants. This is used to shape the "Occupant Use of Fans" Polygon and the default is set ot 1 m/s, which is right below the speed at which papers on a desk might move in the wind.Goo
Bldg Balance PtbldgBalancePt_An optional number representing the building balance point, which will be used to shape the "Internal Heat Gain" strategy polygon. The default is set to 12.8 C and it is assumed that, above this outdoor temperature, the building is free-running and occupants are able to open windows as they wish. Note that this default balance temperature of 12.8 is fairly low and assumes a large number of inside heat sources or people as well as in insulated envelope.Goo
Solar Heat CapacitysolarHeatCapacity_A number representing the amount of solar flux (W/m2) that is needed to raise the temperature of the therorical building 1 degree Celcius. The lower this number, the more efficiently the space is able to absorb passive solar heat. The default is set to 50 W/m2, which assumes a relatively small passively solar heated zone with full glazing on a the facade.Goo
Time ConstanttimeConstant_A number that represents the amount of time in hours that a therortical building can passively maintain its temperature. This is used to determine how many hours a space can maintain a cool temperature after night flushing for the "Thermal Mass + Night Vent" polygon. It is also used to determine how many hours a space can store solar radiation for the "Passive Solar Heating" polygon. The default is set to 8 hours, which assumes a relatively well-isulated building with a thermal mass typical of most contemporary buildings.Goo

Outputs

NameIDDescriptionType
Strategy ParstrategyParPassive strategy parameters that can be plugged into the "Ladybug_Psychrometric Chart" to adjust the assumptions of the passive strategy polygons.Goo

Video Tutorials

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

Report an Issue  |  Terms of Service