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 the PVsurface or SWHsurface for "Photovoltaics surface" or "Solar Water Heating surface" components, based on initial PV or SWH system sizes.


Location_locationThe output from the "importEPW" or "constructLocation" component. This is essentially a list of text summarizing a location on the earth.Goo
PVmodule Settings_PVmoduleSettingsA list of PV module settings. Use the "Simplified Photovoltaics Module" or "Import CEC Photovoltaics Module" or "Import Sandia Photovoltaics Module" components to generate them.Goo
SWHsystem Settings_SWHsystemSettingsA list of all SWH system settings. Use the "Solar Water Heating System" or "Solar Water Heating System Detailed" components to generate them.Goo
System SizesystemSize_1) In case of PV array: DC (Direct current) power rating of the photovoltaic array in kilowatts (kW) at standard test conditions (STC). 2) In case of SWH array: Capacity of the collectors array in thermal kilowatts (kw) at global or local testing conditions (ISO 9806, EN 12975, ASHRAE 93 ...) - If not supplied, 4 kW will be used as a default. - In kiloWatts (kW) or thermal kiloWatts (kWt).Goo
Array Tilt AnglearrayTiltAngle_An angle from horizontal of the inclination of the PV/SWH array plane. Example: 0 = horizontal, 90 = vertical. (range 0-180) - To get the maximal amount of energy, input the "optimalTilt" output from "Tilt And Orientation Factor"'s component. - If not supplied, location's latitude will be used as default value. - In degrees (°).Goo
Array Azimuth AnglearrayAzimuthAngle_The orientation angle (clockwise from the true north) of the PV/SWH array plane's normal vector. (range 0-360) - To get the maximal amount of energy, input the "optimalAzimuth" output from "Tilt And Orientation Factor"'s component. - If not supplied, the following values will be used as default: 180 (due south) for northern hemisphere, 0 (due north) for southern hemisphere. - In degrees(°).Goo
_________________Script variable PhotovoltaicsSurfaceGoo
Tilted Array HeighttiltedArrayHeight_The height of the array, measured in the tilted plane. It is depends on the height/width of the PV module/SWH collector. It also depends on the way modules/collectors are positioned in PV/SWH array (vertically or horizontally). It can vary from 1 to 2.3 meters x number of modules/collectors in a single PV/SWH column. - If not supplied, default value of 1.6 meters (with a single PV module/SWH collector per row) will be used. - In meters.Goo
Number Of RowsnumberOfRows_Number of rows to which PV or SWH array will be divided to. - If not supplied, 1 will be used as a default value (PV/SWH array will have only 1 row).Goo
Skew Rows DistanceskewRowsDistance_Distance in meters by which PV/SWH rows will be skewed. Use positive distance to skew the rows to the left. And negative distance to skew the rows to the right. - It requires the "numberOfRows_" to be larger than 1 in order to be able to skew the rows. - If not supplied, 0 will be used as a default (no rows skewing).Goo
Minimal Spacing PeriodminimalSpacingPeriod_Analysis period for which the minimal spacing distance between PV modules/SWH collector rows will derived of. In general this analysis period is taken from 9 to 15 hour on a day at which sun is at its lowest position during a year. That is 21th December in Northern and 21th June in Southern hemisphere (winter and summer solstice). However, this may not be economical for locations with higher latitudes due to low electricity generation during December/June. - So the following "minimalSpacingPeriod_" should be used based on location's latitude: * latitude <= 44: 21. December (northern hemisphere) / 21. June (southern hemisphere). 9-15hours * latitude 44 - 53: 15. November or 15. January (northern hemisphere) / 15. May or 15. July (southern hemisphere). 9-15hours * latitude 53 - 57: 15. October or 15. February (northern hemisphere) / 15. April or 15. August (southern hemisphere). 9-15hours * latitude > 57: 15. September or 15. March (for both northern and southern hemisphere). 9-15hours - It requires the "numberOfRows_" to be larger than 1 in order visualize the minimal spacing between rows. - Use Ladybug "Analysis Period" component to define this input. - If not supplied, it will be calculated based on upper mentioned criteria.Goo
Base SurfacebaseSurface_Surface on which PV/SWH array will be laid onto. This can be a surface of an angled or flat roof. Or an angled or flat terrain. A facade of a building etc. - If not supplied, a regular horizontal surface in Rhino's XY plane will be used, as a default.Goo
Array Origin PtarrayOriginPt_UV coordinate of baseSurface_ at which PV_SWH array will start. It ranges from 0 to 1.0 for both U and V coordinate. Use grasshopper's "Construct Point" or "MD slider" components to input it. - If not supplied, (0.5,0,0) will be used as a default value.Goo
Array Origin CornerarrayOriginCorner_Corner at which the PV/SWH array begins: - 0 - center bottom 1 - left bottom 2 - right bottom 3 - center top - If not supplied, 0 will be used as a default (bottom center).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
_________________Script variable PV_SWH_SystemSizeGoo
Energy Load Per HourenergyLoadPerHour_A list of energy load values for each hour, during a year. 1) In case of PV array: Electrical energy used for any kind of load: heating, cooling, electric lights, solar water heating circulation pump etc. Use Honeybee "Read EP Result" component or any other one to generate it. - 2) In case of SWH array: Thermal heating energy (or electrical energy) required to heat domestic hot water and/or space heating load and/or space cooling load. Use Ladybug "Residential Hot Water" or "Commercial Public Apartment Hot Water" components to calculate it (simply plugin their "heatingLoadPerHour" outputs). - The purpose of this input is to divide the energy loads to each PV/SWH array rows. - If not inputted, "energyLoadPerRowPerHour" output will not be calculated.Goo


PV SWHsurfacePV_SWHsurfaceSurfaces on which PV modules/SWH collectors will be laid on.Goo
PV SWHsurfaces AreaPV_SWHsurfacesAreaTotal area of the PV_SWHsurfaces. - In Rhino documents units (meters, centimeters, feets...).Goo
Minimal SpacingminimalSpacingMinimal distance between fixed (anchor) points of rows. The distance is measured on the ground (or along the base surface if it has been inputted). - In meters.Goo
Minimal Spacing DateminimalSpacingDateExact date taken from "minimalSpacingPeriod_" input for which minimal spacing between rows has been calculated.Goo
Array Origin PtarrayOriginPtOrigin point of the PV / SWH array.Goo
Energy Load Per Row Per HourenergyLoadPerRowPerHour"energyLoadPerHour_" input's data divided to rows.Goo

Video Tutorials

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

Report an Issue  |  Terms of Service