Population Weighted HDDs

This endpoint provides Population Weighted Heating Degree Days (HDD) for all 50 US states, using all available forecast hours. HDD measures how cold a day is relative to a 65°F base, weighted by population density to better reflect energy demand.

A model parameter can be provided to specify which weather model’s forecast HDDs to retrieve. You can find a list of available models here.

If no model is provided, the latest available model is used by default.

insights/v1/<model>/hddsinsights/v1/<model>/hdds

windborne hddswindborne hdds

from windborne import get_population_weighted_hddsfrom windborne import get_population_weighted_hdds

Query parameters

Name	Description	Format
initialization_time optional	The initialization time for the forecast. Uses only date, hour and minutes. Seconds are discarded.	YYYY-MM-DDThh:mm:ssZ

Name	Description	Format
initialization_time optional	The initialization time for the forecast. Uses only date, hour and minutes. Seconds are discarded.	YYYY-MM-DDThh:mm:ssZ

Name	Description	Format
initialization_time optional	The initialization time for the forecast. Uses only date, hour and minutes. Seconds are discarded.	YYYY-MM-DDThh:mm:ssZ

Name	Description	Format
initialization_time optional	The initialization time for the forecast. Uses only date, hour and minutes. Seconds are discarded.	YYYY-MM-DDThh:mm:ssZ

Name	Description	Format
initialization_time optional	The initialization time for the forecast. Uses only date, hour and minutes. Seconds are discarded.	YYYY-MM-DDThh:mm:ssZ

Name	Description
initialization_time optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded.
-m --model	Set to wm-4 .
-o, --output Optional	Output file path. Supports .csv and .json. If omitted, prints to console. CSV will have states as rows and dates as columns.

Name	Description
initialization_time optional	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded.
-m --model	Set to ecmwf-det .
-o, --output Optional	Output file path. Supports .csv and .json. If omitted, prints to console.

Name	Description
initialization_time optional	The initialization time for the forecast. Formats: YYYYMMDDHH, YYYY-MM-DDTHH, YYYY-MM-DDTHH:mm:ss.
-m --model	Set to ecmwf-ens .
-o, --output Optional	Output file path. Supports .csv and .json.

Name	Description
initialization_time optional	The initialization time for the forecast.
-m --model	Set to aifs .
-o, --output Optional	Output file path. Supports .csv and .json.

Name	Description
initialization_time optional	The initialization time for the forecast.
-m --model	Set to gfs .
-o, --output Optional	Output file path. Supports .csv and .json.

Name	Type	Description
initialization_time optional	str	An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded.
model	str	Set to wm-4 .
output_file Optional	str	Path to save the response data. Supports .csv and .json. CSV will have states as rows and dates as columns.
print_response Optional	bool	Whether to print the response data to console. Defaults to False.

Name	Type	Description
initialization_time optional	str	The initialization time for the forecast.
model	str	Set to ecmwf-det .
output_file Optional	str	Path to save the response data. Supports .csv and .json.
print_response Optional	bool	Whether to print the response data to console. Defaults to False.

Name	Type	Description
initialization_time optional	str	The initialization time for the forecast.
model	str	Set to ecmwf-ens .
output_file Optional	str	Path to save the response data. Supports .csv and .json.
print_response Optional	bool	Whether to print the response data to console. Defaults to False.

Name	Type	Description
initialization_time optional	str	The initialization time for the forecast.
model	str	Set to aifs .
output_file Optional	str	Path to save the response data. Supports .csv and .json.
print_response Optional	bool	Whether to print the response data to console. Defaults to False.

Name	Type	Description
initialization_time optional	str	The initialization time for the forecast.
model	str	Set to gfs .
output_file Optional	str	Path to save the response data. Supports .csv and .json.
print_response Optional	bool	Whether to print the response data to console. Defaults to False.

Response parameters

Returns population weighted heating-degree-days (HDD) data for all 50 US states and the list of forecast dates.

Name	Description	Format
hdd	HDD values keyed by forecast date_string; each date maps to a state-to-value object	object
date_string	Object keyed by state_name with HDD values for that date	object
state_name	HDD value for the given state on that date_string	floating point number
dates	Array of forecast dates in YYYY-MM-DD format	YYYY-MM-DD
date	Forecast date in YYYY-MM-DD format	-

GET Population Weighted HDDs

Query parameters

Response parameters