# Model Input and Output¶

## Input¶

The Bucky model uses two main sources of input: the input graph and CDC-recommended parameters.

### Input Graph¶

The input graph contains data regarding demographics, geographic information, and historical case information. For details, see Graph Information.

## Output¶

The Bucky model generates one file per Monte Carlo run. This data is post-processed to combine data across all dates and simulations. It can then be aggregated at desired geographic levels. A separate file is created for each requested administrative level, with each row indexed by data, admin ID, and quantile. The columns of this output file are described in the tables below.

Aggregated files are placed in subfolder named using the Monte Carlo ID within the specified output directory. Filenames are constructed by appending the aggregation level with the aggregation type (quantiles vs mean). For example, the following file contains quantiles at the national level:

/output/2020-06-10__14_13_04/adm0_quantiles.csv

An example output directory structure is shown below:

2020-07-28__15_21_52/
├── maps
│       ├── ...
└── plots
│   ├── DailyReportedCases_Alabama.png
│   ├── ...
├── US.csv
└── US.png


### Column and Index Names¶

Index name

Description

date

The date

quantile

Quantile value

Column name

Description

case_reporting_rate

Case reporting rate

active_asymptomatic_cases

Current number of actively infectious but asymptomatic cases

cumulative_cases

Cumulative number of cumulative cases (including unreported)

cumulative_deaths

Cumulative number of deaths

cumulative_deaths_per_100k

Cumulative number of deaths per 100,000 people

cumulative_reported_cases

Cumulative number of reported cases

cumulative_reported_cases_per_100k

Number of reported cumulative cases per 100,000 people

current_hospitalizations

Current number of hospitalizations

current_hospitalizations_per_100k

Number of current hospitalizations per 100,000 people

current_icu_usage

ICU bed usage

current_vent_usage

Current ventilator usage

total_population

Population

daily_cases

Number of daily new cases (including unreported)

daily_deaths

Number of daily new deaths

daily_hospitalizations

Number of daily new hospitalizations

daily_reported_cases

Number of reported daily new cases

doubling_t

Local doubling time as estimated from the historical data

R_eff

Local effective reproductive number