Skip to content

Short-term forecasts for influenza at the city- and county-level

License

Notifications You must be signed in to change notification settings

reichlab/flu-metrocast

Repository files navigation

Flu MetroCast Hub 2025-2026 Guidelines

Run by epiENGAGE––an Insight Net Center for Implementation within the U.S. Centers for Disease Control and Prevention (CDC)’s Center for Forecasting and Outbreak Analytics (CFA)

Table of Contents

Executive summary

The Flu MetroCast Hub is a collaborative modeling project that collects and shares weekly probabilistic forecasts of influenza activity at the metropolitan level in the United States. This modeling hub is led by the epiENGAGE team at the University of Texas at Austin and the University of Massachusetts Amherst.

Accurate predictions of key public health surveillance indicators––such as the percentage of emergency department (ED) visits due to influenza or influenza-like illness (ILI)––can shed light on seasonal trends, disease severity, and healthcare system strain. While many U.S. infectious disease forecasting hubs provide state- or national-level forecasts, the Flu MetroCast Hub fills an important gap by aggregating and evaluating forecasts at the sub-state level.

Metro-level forecasting provides several key benefits:

  • Reveals local patterns that state-level forecasts can miss, leading to more accurate and timely decisions.
  • Builds modeling capacity and data infrastructure that strengthen readiness for future outbreak.
  • Generates insights that are accessible and actionable for public health officials, healthcare systems, and community leaders.

From November 19, 2025 through May 20, 2026, participating modeling teams will submit weekly quantile forecasts of the percentage of ED visits due to influenza (or ILI for NYC) for forecast horizons ranging from 0 to +3 weeks. For the 2025-2026 season, all forecasts––except those for NYC and North Carolina––will use publicly-available data from the CDC’s National Syndromic Surveillance Program (NSSP). These data provide weekly estimates of the percentage of influenza-related ED visits at the level of Health Service Areas (HSAs), which are single- or multi-county clusters reflecting local healthcare catchments that often align with metropolitan areas. Forecasts for NYC will use data from the New York City Department of Health and Mental Hygiene’s EpiQuery - Syndromic Surveillance Data. Forecasts for North Carolina will use data from the North Carolina Division of Public Health's (NC DPH) statewide syndromic surveillance system.

All forecasts and observed target data will be publicly available in the Flu MetroCast GitHub repository, following Hubverse standards. Model submissions will be validated for compliance with these standards and incorporated into an ensemble forecast. Both ensemble and individual model outputs will be displayed on a public-facing interactive dashboard. Forecasts will be evaluated in real time using metrics such as the weighted interval score (WIS), and results will be publicly reported. A pre-registered evaluation will be conducted at the end of the season.

The following guidelines provide detailed instructions for participating teams on submission deadlines, forecast targets, data sources, and standardized formatting, submission, and validation procedures.

Anyone interested in using these data for additional research or publications should contact us at epiengage@austin.utexas.edu for information on proper attribution of the source forecasts.


Metro-level Forecasts of Influenza During the 2025-2026 Season

Dates

The initial Flu MetroCast Hub submission will be due on Wednesday, November 19, 2025, with subsequent weekly submissions until May 20, 2026.

Contingency note: During the U.S. government shutdown in October and November 2025, NSSP data releases were paused. If the shutdown remains in effect on November 19th, the Hub will collect only NYC forecasts on this date. Forecasts using NSSP data will commence on the first Wednesday after NSSP data are publicly released.

Participating teams must submit weekly forecasts by 8 PM Eastern Time each Wednesday (the Forecast Due Date) for inclusion in the ensemble model. This deadline aligns with the early Wednesday release of NSSP data on the percentage of ED visits. Any changes to the Forecast Due Date (e.g., due to holidays) will be communicated promptly by the MetroCast organizing team.

Each weekly submission file must include the reference date––defined as the Saturday following the Forecast Due Date––in its filename, following the format: YYYY-MM-DD-team-model.csv, where YYYY-MM-DD indicates the reference date.


Prediction targets

From November through May, participating teams will submit weekly probabilistic (quantile) forecasts of the percentage of ED visits due to influenza.

The Hub will primarily collect forecasts at the city-, county-, region-, or metro-level (typically corresponding to HSAs) and, for validation, will also collect predictions for the corresponding state-level forecasts.


Jurisdictions using NSSP HSA-Level data

At launch, this group includes all locations except New York City. For these jurisdictions, teams should submit:

  • Weekly quantile forecasts of the percentage of ED visits due to influenza at the HSA level (referred to by a representative city or county name), and
  • Weekly quantile forecasts of the percentage of ED visits due to influenza at the state level.

A full list of local and state jurisdictions to be forecasted can be found in the locations.csv file in the Hub repository. We expect that additional jurisdictions may be added to this list based on data availability and interest as the season progresses.

Forecasts should cover horizons 0 to +3 weeks, defined as follows:

  • Horizon = 0: the current epidemiological week encompassing the Sunday prior to the Forecast Due Date through the upcoming Saturday.

For more information on forecast horizons, see the horizon subsection in the model-output README.

Target name, horizon, and aggregate jurisdiction for NSSP HSA-level forecasts. The target refers to the percentage of ED visits in a given week due to influenza.

Target name Horizon Aggregate jurisdiction
Flu ED visits pct 0 to +3 weeks Corresponding state –– Colorado, Georgia, Indiana, Maine, Maryland, Massachusetts, Minnesota, South Carolina, Texas, Utah, Virginia

New York City (NYC) forecasts

For New York City, the Hub will collect:

  • Weekly quantile forecasts of the percentage of ED visits due to influenza-like illness at the citywide (NYC) level.

Forecasts for NYC should also cover horizons 0 to +3 weeks.

Target name and horizon for NYC forecasts. The target refers to the percentage of ED visits in a given week due to influenza-like illness.

Target name Horizon
ILI ED visits pct 0 to +3 weeks

North Carolina (NC) forecasts

For North Carolina, the Hub will collect:

  • Weekly quantile forecasts of the percentage of ED visits due to influenza at a regional level.
  • Weekly quantile forecasts of the percentage of ED visits due to influenza at the state level.

NC monitors sub-state influenza trends by geographic regions comprised of adjacent counties. Seven regions in total have been predetermined for ongoing influenza surveillance. Current influenza trends and a map of the regions can be found on the NC DPH Respiratory Virus Surveillance Dashboard. A table of the regions with their corresponding counties can be found below:

Region Name Aggregate Counties
Northeastern, NC Beaufort, Bertie, Camden, Chowan, Craven, Currituck, Dare, Edgecombe, Gates, Greene, Halifax, Hertford, Hyde, Jones, Lenoir, Martin, Nash, Northampton, Pamlico, Pasquotank, Perquimans, Pitt, Tyrrell, Washington, Wilson
Southeastern, NC Brunswick, Carteret, Columbus, Duplin, New Hanover, Onslow, Pender
Fayetteville Area, NC Bladen, Cumberland, Harnett, Hoke, Johnston, Lee, Moore, Richmond, Robeson, Sampson, Scotland, Wayne
Research Triangle Park Area, NC Alamance, Chatham, Durham, Franklin, Granville, Orange, Person, Vance, Wake, Warren
Triad Area, NC Alleghany, Ashe, Caswell, Davidson, Davie, Forsyth, Guilford, Montgomery, Randolph, Rockingham, Stokes, Surry, Watauga, Wilkes, Yadkin
Western, NC Avery, Buncombe, Burke, Caldwell, Cherokee, Clay, Graham, Haywood, Henderson, Jackson, Macon, Madison, McDowell, Mitchell, Polk, Rutherford, Swain, Transylvania, Yancey
Charlotte Area, NC Alexander, Anson, Cabarrus, Catawba, Cleveland, Gaston, Iredell, Lincoln, Mecklenburg, Rowan, Stanly, Union

Forecasts for NC should also cover horizons 0 to +3 weeks.

Target name and horizon for NC forecasts. The target refers to the percentage of ED visits in a given week due to influenza.

Target name Horizon
Flu ED visits pct 0 to +3 weeks

Model output data storage

The Flu MetroCast Hub will store a live dataset in this dedicated GitHub repository, following Hubverse file-based data storage standards. The repository will contain separate directories for model output and model metadata submissions from modeling teams.

Model output must follow a tabular representation where each row represents a single prediction and each column provides additional information about the prediction (see the Forecast File Format section). Model output may be submitted as CSV or Parquet files.


Target data

Target data are the “ground truth” observed data being modeled as the prediction target. You can find the raw and target data in the raw-data and target-data folders of the MetroCast GitHub repository. Raw data represent ground truth data in its raw or native form. Target data are specially formatted raw data that can be used for model fitting, visualization, or evaluation purposes.

The target data for forecasts of locations with NSSP data are based on the weekly percentage of total ED visits associated with influenza, available from the CDC’s National Syndromic Surveillance Program (NSSP).

The target data for NYC forecasts are based on the weekly percentage of total ED visits associated with influenza-like illness, available from the New York City Department of Health and Mental Hygiene’s EpiQuery - Syndromic Surveillance Data.

The target data for North Carolina (NC) forecasts are based on the weekly percentage of total ED visits associated with influenza, and provided by The North Carolina Disease Event Tracking and Epidemiologic Collection Tool (NC DETECT) is North Carolina’s statewide syndromic surveillance system. NC DETECT was created by the North Carolina Division of Public Health (NC DPH) in 2004 in collaboration with the Carolina Center for Health Informatics (CCHI) in the UNC Department of Emergency Medicine to address the need for early event detection and timely public health surveillance in North Carolina using a variety of secondary data sources.

Time-series target data for the most recent complete epidemiological week (EW) (i.e., Sunday through Saturday of the previous week) will be updated by midday Wednesday for NSSP, NYC, and NC data. Since NYC data updates daily, more recent data for NYC are available for the current incomplete EW that modelers can access on their own and use in their model. NC data are only updated on a weekly basis.

Please see the target-data README for more information on target data formats.


Forecast formatting

Participating modeling teams must submit weekly quantile forecasts of the percentage of influenza or influenza-like illness (NYC only) to the model-output subdirectory of a hub.

For each model, teams must submit one model metadata file to the model-metadata subdirectory.

Forecasts must follow Hubverse standards, including naming conventions, required columns, and valid values for all required fields, to ensure that model output can be easily aggregated, visualized, and evaluated with downstream tools. All submissions must pass automated validation before being accepted.

Please see the model-output README for detailed instructions on formatting and submission requirements.


Forecast submission and validation

To ensure proper data formatting, pull requests for new data in model-output/ will be automatically run. Optionally, you may also run these validations locally. Please see the model-output README for detailed instructions on formatting and submission requirements.


Evaluation criteria

Forecasts will be evaluated using a variety of metrics, including weighted interval score (WIS) and its components and prediction interval coverage. Evaluation will use official data reported by the CDC and New York Department of Health and Mental Hygiene.

Our evaluation plan focuses on two main questions:

  1. When and where do local forecasts provide the greatest benefit? We will compare local- and state-level forecasts to determine where local forecasts yield more accurate predictions of community-level influenza trends. We will also examine whether their utility is associated with jurisdictional characteristics such as population density, geographic size, and the number or distribution of population centers.

  2. Which forecasting models perform best, and why? We will identify the models that perform most reliably for each location and evaluate how performance varies across jurisdictions and spatial scales. We will also assess which modeling approaches perform best overall and explore factors that may explain differences in performance.


Publication of forecasts

All participants provide consent for their forecasts and evaluation thereof to be published in real-time on the Flu MetroCast dashboard, the Flu Metrocast Hub repository, and potentially in a scientific journal describing the results of the forecasting challenge.

About

Short-term forecasts for influenza at the city- and county-level

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 20