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 generate a clear sky for a cooling design day, which can then be used to size a HVAC system. This component outputs both the hourly solar radiation values as well as a cumulative sky that can be used in solar radiation studies (if requested).
Specifically, this component uses the ASHRAE Revised Clear Sky Model (“Tau Model”), which was originally published in the ASHRAE 2009 Handbook of Fundementals (American Society of Heating, Refrigerating and Air-Conditioning Engineers. (2009). 2009 ASHRAE handbook: Fundamentals. Atlanta, GA: American Society of Heating, Refrigeration and Air-Conditioning Engineers).
The "Tau Model" is currently the recommended sky model for cooling design day calculations and is the default assumption of Honeybee EnergyPlus HVAC sizing calculations.
More information on the calculation for the can be found in the EnergyPlus Input/Output reference:
http://bigladdersoftware.com/epx/docs/8-4/engineering-reference/climate-calculations.html#ashrae-revised-clear-sky-model-tau-model

Inputs

NameIDDescriptionType
Location_locationThe output from the importEPW or constructLocation component. This is essentially a list of text summarizing a location on the earth.Goo
Tau Beam_tauBeamValues representing the optical sky depth for beam (direct) solar radiation. Optical depth is the natural logarithm of the ratio of incident to transmitted radiant power through the atmosphere. It can vary from month to month as water vapor concentrations in the atmosphere change. This input can be either a single value for the whole year, a list of 12 monthly values, or the output from the "Ladybug_Import stat" component. Typical values range from 0.3 in cool dry months to 0.65 in warm humid months.Goo
Tau Diffuse_tauDiffuseValues representing the optical sky depth for diffuse solar radiation. Optical depth is the natural logarithm of the ratio of incident to transmitted radiant power through the atmosphere. It can vary from month to month as water vapor concentrations in the atmosphere change. This input can be either a single value for the whole year, a list of 12 monthly values, or the output from the "Ladybug_Import stat" component. Typical values range from 1.75 in warm humid months to 2.5 in cool dry months.Goo
Sky Density_skyDensity_Set to 0 to generate a Tregenza sky, which will divide up the sky dome with a coarse density of 145 sky patches. Set to 1 to generate a Reinhart sky, which will divide up the sky dome using a very fine density of 580 sky patches. Note that, while the Reinhart sky is more accurate, it will result in considerably longer calculation times. Accordingly, the default is set to 0 for a Tregenza sky.Goo
Working DirworkingDir_An optional working directory in your system where the sky will be generated. Default is set to C:\Ladybug or C:\Users\yourUserName\AppData\Roaming\Ladybug. The latter is used if you cannot write to the C:\ drive of your computer. Any valid file path location can be connected.Goo
Use Old ResuseOldRes_Set this to "True" if you have already run this component previously and you want to use the already-generated data for this weather file.Goo
Gen Cum SkygenCumSky_Set to 'True' to have this component generate a cumulative sky matrix for the design day sky. This can then be used in Ladybug solar radiation studies and visualized with the "Ladybug_Sky Dome" or "Ladybug_Radiation Rose."Goo

Outputs

NameIDDescriptionType
OutreadMe!...String
Direct Norm RaddirectNormRadThe hourly Direct Normal Radiation in Wh/m2 for an ASHRAE Revised Clear Sky (“Tau Model”). Direct normal radiation is the amount of solar radiation in Wh/m2 received directly from the solar disk on a surface perpendicular to the sun's rays.Goo
Diffuse Horiz RaddiffuseHorizRadThe hourly Diffuse Horizontal Radiation in Wh/m2 for an ASHRAE Revised Clear Sky (“Tau Model”). Diffuse horizontal radiation is the amount of solar radiation in Wh/m2 received from the sky (excluding the solar disk) on a horizontal surface. globalHorizRad; The hourly Global Horizontal Radiation in Wh/m2 for an ASHRAE Revised Clear Sky (“Tau Model”). Diffuse horizontal radiation is the total amount of direct and diffuse solar radiation in Wh/m2 received on a horizontal surface.Goo
Global Horiz RadglobalHorizRadScript variable DesignDaySkyGoo
Cumulative Sky MtxcumulativeSkyMtxThe result of the gendaymtx function. Use the selectSkyMtx component to select a desired sky matrix from this output for use in a radiation study, radition rose, or sky dome visualization.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