Population Weighted CDDs

This endpoint provides opulation weighted cooling degree days (CDD) forecasts for all 50 US states. CDD is a measure of how hot the temperature was on a given day relative to a base temperature of 65°F, weighted by population density to provide more accurate energy demand forecasting.

A model parameter can be provided to specify which weather model’s CDDs 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>/cddsinsights/v1/<model>/cdds

windborne cddswindborne cdds

from windborne import get_population_weighted_cddsfrom windborne import get_population_weighted_cdds

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 cooling-degree-days (CDD) data for all 50 US states and the list of forecast dates.

Name	Description	Format
cdd	CDD values keyed by forecast date_string; each date maps to a state-to-value object	object
date_string	Object keyed by state_name with CDD values for that date	object
state_name	CDD 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 CDDs

Query parameters

Response parameters