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

Calculates heating and cooling degree-days.
Traditionally, degree-days are defined as the difference between a base temperature and the average ambient air temperature multiplied by the number of days that this difference exists.
By default, this component uses a more accurate calculation than the traditional method based on the minimum and maximum temperature of each day.
You may check the formulas in this page: "http://www.vesma.com/ddd/ddcalcs.htm"
If you rather to use the traditional method, set useDailyAvrMethod to True.

Inputs

NameIDDescriptionType
Hourly Dry Bulb Temperature_hourlyDryBulbTemperatureAnnual dry bulb temperature from the Import epw component (in degrees Celsius).Goo
Cooling Base Temperature_coolingBaseTemperature_Base temperature for cooling (in degrees Celsius). Default is set to 23.3C but this can be much lower if the analysis is for a building with high heat gain or insulation. Also, this number differs based on the factors that affect the human energy balance of the occupants inside of the buildings such as; building program, climate zone, solar exposure, number, age, activity, and clothing of occupants, lighting, equipment, insulation, etc. Therefore, it is highly recommended to set this number as a temperature at which the building will start cooling.Goo
Heating Base Temperature_heatingBaseTemperature_Base temperature for heating (in degrees Celsius). Default is set to 18.3C but this can be much lower if the analysis is for a building with high heat gain or insulation. Also, this number differs based on the factors that affect the human energy balance of the occupants inside of the buildings such as; building program, climate zone, solar exposure, number, age, activity, and clothing of occupants, lighting, equipment, insulation, etc. Therefore, it is highly recommended to set this number as a temperature at which the building will start heating.Goo
Use Daily Avr MethoduseDailyAvrMethod_set to "True" to use the traditional method of degree days calculation, which will calculate the average temperature of each day and sum up all of these temperatures over the year. This is opoosed to this component's default analysis, which will will examine each hour of the year and then convert results to degree-days.Goo

Outputs

NameIDDescriptionType
OutreadMe!A summary of the input.String
Daily cooling Deg Daysdaily_coolingDegDaysCooling degree-days summed for each day of the year. For visualizations of over the whole year, connect this to the grasshopper chart/graph component. Goo
Daily heating Deg Daysdaily_heatingDegDaysHeating degree-days summed for each day of the year. For visualizations of over the whole year, connect this to the grasshopper chart/graph component. Goo
Monthly cooling Deg Daysmonthly_coolingDegDaysCooling degree-days summed for each month of the year.Goo
Monthly heating Deg Daysmonthly_heatingDegDaysHeating degree-days summed for each month of the year.Goo
Annual cooling Deg Daysannual_coolingDegDaysThe total cooling degree-days for the entire year.Goo
Annual heating Deg Daysannual_heatingDegDaysThe total heating degree-days for the entire year.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