# CDC RSV Forecast Hub: Weekly Probabilistic Forecasts of RSV Hospital Admissions and Emergency Department Visits by U.S. State (Hubverse)

## Facts

- Provider: U.S. Centers for Disease Control and Prevention (CDC) and participating modeling teams
- License: Public Domain (US Government work) (https://github.com/CDCgov/rsv-forecast-hub)
- Format: CSV (in sampled files)
- Stored at: Amazon S3, s3://rsv-forecast-hub (us-east-1)
- Access: public, readable without an account
- Category: Health & Biomedical
- Source: https://docs.hubverse.io/
- Page: https://scigantic.com/archive/9497658e-a406-544a-9493-c5a33e046df6
- Keywords: Health & Biomedical, time series, CSV, AWS Open Data

## About

The RSV Forecast Hub, run by the U.S. Centers for Disease Control and Prevention (CDC), collects weekly probabilistic nowcasts and forecasts of RSV activity from participating modeling teams, together with the observed target data used to score them. Teams forecast, for the United States, all 50 states, Washington DC and Puerto Rico, the weekly number of laboratory-confirmed RSV hospital admissions reported to the National Healthcare Safety Network (NHSN) Hospital Respiratory Data, and the weekly percent of emergency department (ED) visits due to RSV from the National Syndromic Surveillance Program (NSSP), for horizons from the previous epiweek to three weeks ahead. Forecasts are quantiles and, optionally, sampled trajectories, in the hubverse model-output schema. This public bucket is the hub's real-time mirror: model-output/ (one folder per team model, for example RSVHub-baseline), model-metadata/ (each model's description and data license), target-data/ (the observed time series), hub-config/ and auxiliary-data/; the raw/ folder is internal and should not be used. Use it for infectious disease forecasting research, ensemble methods and forecast evaluation (weighted interval score, coverage). Read with the hubverse hub-data (Python) or hubData (R) packages, pyarrow or pandas. License: the repository is a U.S. Government work in the public domain; each model's output carries the license named in model-metadata (CC BY 4.0, CC BY-SA 4.0 or CC0). Contact rsvhub@cdc.gov about attribution of source forecasts.

## Load the data

```python
import boto3
from botocore import UNSIGNED
from botocore.client import Config
s3 = boto3.client('s3', region_name='us-east-1', config=Config(signature_version=UNSIGNED))
s3.list_objects_v2(Bucket='rsv-forecast-hub', Prefix='', Delimiter='/')
```

Lists the files with anonymous access. Runs on any machine, with no cloud account.

## Data structure

File types in sampled files: CSV

Example file: `auxiliary-data/weekly-model-submissions/2025-09-27-models-submitted-to-hub.csv`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/9497658e-a406-544a-9493-c5a33e046df6
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/9497658e-a406-544a-9493-c5a33e046df6
- Over MCP: `get_schema_card` with id `9497658e-a406-544a-9493-c5a33e046df6` at https://api.scigantic.com/mcp

## Related topics

- [CSV datasets](https://scigantic.com/topics/csv)
- [Health & Biomedical datasets](https://scigantic.com/topics/health-and-biomedical)
- [Time series datasets](https://scigantic.com/topics/time-series)
