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

This component calculates the Optimal Tilt, Optimal Orientation and TOF (Tilt and Orientation Factor) for PV modules or Solar water heating collectors.
TOF is a solar radiation at the actual tilt and orientation divided by the solar radiation at the optimum tilt and orientation.

Inputs

NameIDDescriptionType
Epw File_epwFileInput .epw file path by using the "File Path" parameter, or Ladybug's "Open EPW And STAT Weather Files" component.Goo
PV SWHsurface_PV_SWHsurface- Input planar Grasshopper/Rhino Surface (not a polysurface) on which the PV modules/SWH collectors will be applied. If you have a polysurface, explode it (using "Deconstruct Brep" component) and then feed its Faces(F) output to _PV_SWHsurface. Surface normal should be faced towards the sun. - Or create the Surface based on initial PV/SWH system size by using "PV SWH system size" component.Goo
Annual ShadingannualShading_Losses due to buildings, structures, trees, mountains or other objects that prevent solar radiation from reaching the PV module/Solar water heating collector. Input range: 0 to 100(%), 0 being unshaded, and 100 being totally shaded PV module/SWH collector. - If not supplied default value of 0(%) will be used.Goo
Northnorth_Input a vector to be used as a true North direction, or a number between 0 and 360 that represents the clockwise degrees off from the Y-axis. - If not supplied, default North direction will be set to the Y-axis (0 degrees).Goo
Albedoalbedo_A list of 8767 (with header) or 8760 (without the header) albedo values for each hour during a year. Albedo (or Reflection coefficient) is an average ratio of the global incident solar radiation reflected from the area surrounding the PV surface. It ranges from 0 to 1. - It depends on the time of the year/day, surface type, temperature, vegetation, presence of water, ice and snow etc. - If no list supplied, default value of 0.20 will be used, corrected(increased) for the presence of snow (if any). - Unitless.Goo
___________________Script variable PhotovoltaicsSurfaceGoo
Precisionprecision_Represents the square root number of analysis field for the output "geometry" mesh. Ranges from 1-100. Example - precision of 4, would mean that 4 fields in X direction (Azimuth) and 4 fields in Y direction (Tilt) = 16 fields, will be used to calculate the final "geometry" mesh. For lower precision numbers (say < 20) even precision numbers are more accurate. - If not supplied, default value of 20 will be used.Goo
Scalescale_Scale of the overall geometry. - If not supplied, default value of 1 will be used.Goo
Originorigin_Origin for the final "geometry" output. - If not supplied, default point of (-15,0,0) will be used.Goo
Legend ParlegendPar_Optional legend parameters from the Ladybug "Legend Parameters" component.Goo
Analysis PeriodanalysisPeriod_Script variable TOFGoo
___________________Script input ______________________.Goo
Bake ItbakeIt_Set to "True" to bake the Tilt and orientation factor results into the Rhino scene. - If not supplied default value "False" will be used.Goo
Run It_runIt...Goo

Outputs

NameIDDescriptionType
OutreadMe!...String
___________________Script variable PhotovoltaicsSurfaceGoo
TOFTOFTilt and Orientation Factor - solar radiation at the actual tilt and azimuth divided by the solar radiation at the optimum tilt and azimuth. In percent(%).Goo
TSRFTSRFTotal Solar Resource Fraction - the ratio of solar radiation available accounting for both annual shading and TOF, compared to the solar radiation available at a given location at the optimum tilt and azimuth and with no shading. Calculated according to the following equation: TSRF = TOF * (100-annualShading)/100 Some USA states, like Oregon and Washington require TSRF to be minimum 75% in order for the PV system to be applicable for incentive programs. - In percent(%).Goo
PVsurface TiltPVsurfaceTiltTilt angle of the inputted PV_SWHsurface. In degrees (°).Goo
PVsurface AzimuthPVsurfaceAzimuthOrientation angle of the inputted PV_SWHsurface. In degrees (°).Goo
Optimal TiltoptimalTiltOptimal tilt of the PV_SWHsurface for a given location. Optimal tilt being the one that receives the most annual solar radiation. In degrees (°).Goo
Optimal AzimuthoptimalAzimuthOptimal orientation of the PV_SWHsurface for a given location. Optimal azimuth being the one that receives the most annual solar radiation. In degrees (°).Goo
Optimal Roof PitchoptimalRoofPitchOptimal steepness of the PV_SWHsurface for a given location. Optimal steepness being the one that receives the most annual solar radiation. In inches/inchesGoo
Optimal RadiationoptimalRadiationTotal solar radiation per square meter for a whole year received on a PV_SWHsurface of optimal tilt and azimuth, at given location. In kWh/m2Goo
___________________Script variable TOFGoo
GeometrygeometryGeometry of the whole TOF mesh chart. Connect this output to a Grasshopper's "Geo" parameter in order to preview the "geometry" separately in the Rhino scene.Goo
Origin PtoriginPtThe origin point of the "geometry" output. Use this point to move "geometry" output around in the Rhino scene with the grasshopper's "Move" component.Goo
Analysis PtanalysisPtA point indicating inputted PV_SWHsurface's Tilt/Azimuth position on the solar radiation table.Goo
LegendlegendA legend for the annual total solar radiation (in kWh/m2). Connect this output to a Grasshopper's "Geo" parameter in order to preview the legend separately in the Rhino scene. Goo
Legend Base PtlegendBasePtLegend base point, which can be used to move the "legend" geometry with grasshopper's "Move" component.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