The COVID-19 & Economy simulation jointly models infection dynamics and economic activity. It is built on empirical data and fitted epidemiological and economic models drawn from the real-world trajectory of the COVID-19 pandemic in the United States.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/salesforce/ai-economist/llms.txt
Use this file to discover all available pages before exploring further.
What the simulation models
The environment comprises 51 agents — each representing a US state or Washington D.C. — and one federal government planner. At each timestep (one day):- State agents set the stringency level of their pandemic policy response (e.g. lockdown intensity).
- The federal government provides direct payment subsidies to eligible individuals.
- Infection dynamics follow a fitted SIR (Susceptible-Infected-Recovered) model.
- Economic productivity is driven by the fraction of the working-age population that is employed and not too sick to work.
| Mode | use_real_world_data | use_real_world_policies | Description |
|---|---|---|---|
| Fully fitted | False | False | Fitted models drive both health and economic dynamics |
| Real-world policies | False | True | Real policy stringency levels are replayed; dynamics from fitted models |
| Full replay | True | True | Both dynamics and policies match historical data exactly |
Scenario registration
The scenario is registered under the name:CovidAndEconomyEnvironment, defined in:
Key parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
use_real_world_data | bool | False | Replay real-world SIR, unemployment, policy, and vaccination data |
use_real_world_policies | bool | False | Replay historical policy stringency levels |
path_to_data_and_fitted_params | str | "" | Path to the directory containing fitted parameters and real-world data. Defaults to the bundled dataset. |
start_date | str | "2020-03-22" | Simulation start date in YYYY-MM-DD format |
pop_between_age_18_65 | float | 0.6 | Fraction of the population in the working-age bracket |
infection_too_sick_to_work_rate | float | 0.1 | Fraction of infected individuals unable to work |
risk_free_interest_rate | float | 0.03 | Interest rate at which the federal government borrows for direct payments |
economic_reward_crra_eta | float | 2 | CRRA eta parameter for economic reward non-linearity |
health_priority_scaling_agents | float | 1 | How much state agents weight health over the economy relative to the real world (1 = real-world calibration) |
health_priority_scaling_planner | float | 1 | Same as above for the federal government |
reward_normalization_factor | float | 1 | Scalar applied to all rewards before returning them |
Real-world data and fitted parameters
The bundled dataset is located at:real_world_data.npz: Historical SIR, unemployment, government policy stringency, and vaccination time series for all 51 US regions.- Fitted epidemiological and economic model parameters, loaded at init via
load_model_constants()andload_fitted_params().
GPU acceleration with WarpDrive
The COVID-19 simulation supports CUDA C acceleration via WarpDrive. When a GPU is available, the simulation automatically imports WarpDrive constants and data feeds:Instantiating the environment
When
use_real_world_data=True, you must also set use_real_world_policies=True. If use_real_world_policies=True, the episode_length cannot exceed the number of available real-world policy timesteps from start_date.Observation and reward structure
State agents observe:- Current SIR state (susceptible, infected, recovered fractions)
- Current unemployment rate
- Current and recent policy stringency levels
- Subsidy amounts received
- Time index
health_priority_scaling_agents and health_priority_scaling_planner.
Ethical review
This simulation was designed with care. Before using it in research or policy work, please review:- Foundation Simulation Card — intended use and ethical review of the broader framework.
- COVID-19 Simulation Card — ethical aspects specific to the pandemic simulation.
- AI Economist web demo and ethical review
Tutorials
COVID-19 and economic simulation
Introduction to the simulation and how to study health and economic policy trade-offs.
Multi-agent GPU training with WarpDrive
Use WarpDrive for high-throughput GPU-accelerated training on this scenario.