The IEM attempts to process and archive the convective and fire weather outlooks issued by the Storm Prediction Center. This processing is done by parsing the PTS product via pyIEM decoder. Recently, the SPC website has added direct single outlook downloads in various GIS formats. Your best data quality will come from scraping their website, but maybe that approach is not for all users of this data! So here it is, a means to bulk download the IEM's SPC Outlook database.

Related: NWS VTEC Watch Warning Advisory   SPC Convective Discussions   SPC Watch Polygons   WPC Precip Discussions

Time Interval for Outlook *Issuance* (UTC)
YearMonthDay HourMinuteOutlook Type:Outlook Day:


Shapefile DBF schema:

Field 0: Type=C/String, Title='ISSUE', Outlook Beginning Valid Time UTC
Field 1: Type=C/String, Title='EXPIRE', Outlook Ending Valid Time UTC
Field 2: Type=C/String, Title='PRODISS', Timestamp of Product Issuance UTC
Field 3: Type=C/String, Title='TYPE', Either C=Convective, F=Fire Weather
Field 4: Type=N/Double, Title='DAY', Day 1 through 8 for the outlook
Field 5: Type=C/String, Title='THRESHOLD', Threshold Label
Field 6: Type=C/String, Title='CATEGORY', Category of Threshold Label
Field 7: Type=N/Double, Title='CYCLE', The generalized forecast issuance hour

Archive / Usage Notes:

  1. 1 Apr 2021: An assessment was made of the archive completeness and found 99.9% coverage. Some of the holes are due to lost PTS text products yet to be found and others are due to errors within the PTS product causing it to be generally unusable.
  2. The polygons returned by this download represent the full extent of the threshold bounds and not some bisected area only valid for the given threshold. Rewording, if you download an outlook that had a moderate risk polygon. That area would also be covered by an enhanced, slight, and general thunderstorm polygon.
  3. A complication with using this dataset is that all outlooks are returned, the CYCLE attribute attempts to define a canonical outlook for a given issuance cycle. For example, the Day 1 20Z convective outlook may get issued three times for various reasons. The download contains all three, but two of them will have a cycle of `-1` and the other will have a `20`.
  4. Presently, the service only returns outlooks that had actual geographies associated with the outlook. For example, if there was no Day 5 area in the outlook, no entries are included in the download result.