Skip to main content

The Bucky model is a spatial SEIR model for simulating COVID-19 at the county level.

Project description

Bucky Model

Documentation Status black-flake8-isort-hooks CodeFactor Interrogate


Developer Guide

The Bucky model is a spatial SEIR model for simulating COVID-19 at the county level.

Getting Started


The Bucky model currently supports Linux and OSX and includes GPU support for accelerated modeling and processing.

  • git must be installed and in your PATH.
  • GPU support requires a cupy-compatible CUDA installation. See the CuPy docs for details.


Standard installation:

pip install bucky-covid

Choose a working directory

Bucky will produce multiple folders for historical data and outputs. It's recommended to put these in their own directory, for example ~/bucky

mkdir $BUCKY_DIR


The default configuration for bucky is located here. Currently, you can locally modify these options by creating a bucky.yml in BUCKY_DIR that will override any of the default options specified in it.

TODO this is WIP and does not work yet:

To use a customized configuration you first need to make a local copy of the bucky configuration. In your working directory:

bucky cfg install-local

Download Input Data

To download the required input data to the data_dir specified in the configuration files (default is $(pwd)/data:

bucky data sync

Running the Model

To run the model with default settings and produce standard outputs.

bucky run

Equivalently, one can the following command (to provide cli configuration to each part of the process)

bucky run model
bucky run postprocess
bucky viz plot

CLI options

Each bucky command has options that can be detailed with the --help flag. e.g.

$ bucky run model --help

Usage: bucky run model [OPTIONS]

  `bucky run model`, run the model itself, dumping raw monte
  carlo output to raw_output_dir.

  -d INTEGER         Number of days to project forward
                     [default: 30]
  -s INTEGER         Global PRNG seed  [default: 42]
  -n INTEGER         Number of Monte Carlo iterations  [default:
  --runid TEXT       UUID name of current run  [default:
  --start-date TEXT  Start date for the simulation. (YYYY-MM-DD)
  --help             Show this message and exit.

Further CLI documentation is available in the documentation.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bucky-covid-1.0.0a0.post2.tar.gz (961.4 kB view hashes)

Uploaded source

Built Distribution

bucky_covid-1.0.0a0.post2-py3-none-any.whl (980.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page