Tilt And Orientation Factor - [source code]
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. -
epwFile [Required]Input .epw file path by using the "File Path" parameter, or Ladybug's "Open EPW And STAT Weather Files" component.
- 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.
annualShading [Optional]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.
north [Optional]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).
albedo [Optional]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.
precision [Optional]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.
scale [Optional]Scale of the overall geometry. - If not supplied, default value of 1 will be used.
origin [Optional]Origin for the final "geometry" output. - If not supplied, default point of (-15,0,0) will be used.
legendPar [Optional]Optional legend parameters from the Ladybug "Legend Parameters" component.
analysisPeriod [Optional]Script variable TOF
bakeIt [Optional]Set to "True" to bake the Tilt and orientation factor results into the Rhino scene. - If not supplied default value "False" will be used.
TOFTilt and Orientation Factor - solar radiation at the actual tilt and azimuth divided by the solar radiation at the optimum tilt and azimuth. In percent(%).
TSRFTotal 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(%).
PVsurfaceTiltTilt angle of the inputted PV_SWHsurface. In degrees (°).
PVsurfaceAzimuthOrientation angle of the inputted PV_SWHsurface. In degrees (°).
optimalTiltOptimal tilt of the PV_SWHsurface for a given location. Optimal tilt being the one that receives the most annual solar radiation. In degrees (°).
optimalAzimuthOptimal orientation of the PV_SWHsurface for a given location. Optimal azimuth being the one that receives the most annual solar radiation. In degrees (°).
optimalRoofPitchOptimal steepness of the PV_SWHsurface for a given location. Optimal steepness being the one that receives the most annual solar radiation. In inches/inches
optimalRadiationTotal solar radiation per square meter for a whole year received on a PV_SWHsurface of optimal tilt and azimuth, at given location. In kWh/m2
geometryGeometry 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.
originPtThe origin point of the "geometry" output. Use this point to move "geometry" output around in the Rhino scene with the grasshopper's "Move" component.
analysisPtA point indicating inputted PV_SWHsurface's Tilt/Azimuth position on the solar radiation table.
legendA 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.
legendBasePtLegend base point, which can be used to move the "legend" geometry with grasshopper's "Move" component.