Epw File | _epwFile | Input .epw file path by using the "File Path" parameter, or Ladybug's "Open EPW And STAT Weather Files" component. | Goo |
Heating Load Per Hour | _heatingLoadPerHour | Heating load in electrical energy for each hour during a year. In kWh.
It represents domestic hot water heating load.
With added space heating and/or space cooling heating loads.
-
To calculate domestic hot water heating load, use Ladybug "Residential Hot Water" or "Commercial Public Apartment Hot Water" components.
-
Space heating and space cooling loads can be inputted from Honeybee's "Read EP Result" component.
Divide each value of space heating load with 0.7, to account for COP(coefficient of performance) of the heating system.
Space cooling values do not need to be divided with anything (COP = 1.0). | Goo |
SWHsurface | _SWHsurface | - Input planar Surface (not polysurface) on which the SWH collectors will be applied. If you have a polysurface, explode it (using "Deconstruct Brep" component) and then feed its Faces(F) output to _SWHsurface. Surface normal should be faced towards the sun.
- Or create the Surface based on initial SWH system size by using "PV SWH system size" component. | Goo |
SWHsurface Percent | SWHsurfacePercent_ | The percentage of surface which will be used for SWH collectors (range 0-100).
-
There are no general rules or codes which would limit the percentage of the roof(surface) covered with SWH collectors.
-
If not supplied, default value of 100 (all surface area will be covered with SWH collectors) is used. | Goo |
| _________________ | Script variable SolarHotWaterSurface | Goo |
SWHsystem Settings | SWHsystemSettings_ | A list of all Solar water heating system settings. Use the "Solar Water Heating System" or "Solar Water Heating System Detailed" components to generate them.
-
If not supplied, the following swh system settings will be used by default:
- glazed flat plate collectors
- active
- closed loop
- pipe length: 20 meters
- unshaded | Goo |
North | north_ | Input a vector to be used as a true North direction for the sun path, or a number between 0 and 360 that represents the clockwise degrees off from the Y-axis to make North.
-
If not supplied, default North direction will be set to the Y-axis (0 degrees). | Goo |
Albedo | albedo_ | 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 SolarHotWaterSurface | Goo |
Annual Hourly Data | annualHourlyData_ | An optional list of hourly data from Ladybug's "Import epw" component (e.g. dryBulbTemperature), which will be used for "conditionalStatement_". | Goo |
Conditional Statement | conditionalStatement_ | This input allows users to calculate the Solar water heating surface component results only for those annualHourlyData_ values which fit specific conditions or criteria.
To use this input correctly, hourly data, such as dryBulbTemperature or windSpeed, must be plugged into the "annualHourlyData_" input. The conditional statement input here should be a valid condition statement in Python, such as "a>25" or "b<3" (without the quotation marks).
conditionalStatement_ accepts "and" and "or" operators. To visualize the hourly data, English letters should be used as variables, and each letter alphabetically corresponds to each of the lists (in their respective order): "a" always represents the 1st list, "b" always represents the 2nd list, etc.
-
For example, if you have an hourly dryBulbTemperature connected as the first list, and windSpeed connected as the second list (both to the annualHourlyData_ input), and you want to plot the data for the time period when temperature is between 18°C and 23°C, and windSpeed is larger than 3m/s, the conditionalStatement_ should be written as "183" (without the quotation marks).
-
This input can also be used for analysis of drainback systems. Input a "dryBulbTemperature" data from "Import epw" component into upper "annualHourlyData_" input. Then input "a>5" to this ("conditionalStatement_") input. | Goo |
| _________________ | Script variable SolarHotWaterSurface | Goo |
Run It | _runIt | ... | Goo |