Return to API Services.

Documentation for /json/outlook_and_vtec.py

This service emits the combination of SPC/WPC Outlooks and coincident VTEC events. This service is exploratory at the moment and may change as feedback is received. The spatial join is done against the storm based warning polygon.

Changelog

  • 2026-06-03: Initial release.

Example Usage

Provide the combination of Day 1 (8 UTC issuance) Excessive Rainfall Outlook slight risks and Flash Flood Warnings for NWS Des Moines. Require that 5% of the Des Moines CWA be covered by the given outlook to be considered. Only include events during 2024.

https://mesonet.agron.iastate.edu/json/outlook_and_vtec.py?wfo=DMX&sdate=2024-01-01&edate=2024-12-31&day=1&overlap=5&threshold=SLGT&cycle=8&outlook_type=E&phsig=FF.W

CGI Arguments

The following table lists the CGI arguments that are accepted by this service. A HTTP GET request is required. Fields of type Multi-Params or CSV value can accept either a comma separated list or multiple parameter and value combinations. For example, ?foo=1&foo=2 is equivalent to ?foo=1,2.

Field Type Description
wfo string (required) Three character WFO field. You may optionally specify this as a four character full identifier.
day integer The integer value for outlook day, between 1 and 8
sdate string (required) Inclusive outlook start date.
edate string (required) Inclusive outlook end date.
overlap number Overlap minimum percentage for a WFO + ERO
threshold string Outlook threshold abbreviation
cycle integer Outlook issuance cycle
outlook_type string ('Outlook type. E for Excessive Rainfall, C for Convective, F for Fire Weather',)
phsig Multi-Params or CSV value List of phenomena.significance to consider for the VTEC events. For example, FF.W would be Flash Flood Warning.