A zoomable, historical map of COVID-19 cases in the United States by county. This project is written in Svelte/JavaScript and makes extensive use of the mapping/visualization library deck.gl.

The dataset is provided by USAFacts.

This is a standard npm project. To install and run locally, make sure you have Node installed.

Clone from git:

git clone https://github.com/freedmand/covid19map

Enter the directory created and install with:

npm install

Run the project with:

npm run dev

This will launch a server at http://localhost:3000 that you can visit to see the application running.

Run the following command:

npm run build

The public folder will contain the static website that can then be deployed.

To update the dataset, enter the preprocessing directory:

cd preprocessing

Visit the USAFacts dataset page and download the provided CSVs into the preprocessing folder. Also create/overwrite the file last_updated.txt within this same folder with a string containing the updated time that USAFacts provides, e.g. March 25, 2020, at 12:00 AM Pacific/3:00 AM Eastern Time.

Finally, run the processing script with:

python process.py

This will create a binary file called output.bin in the public directory that contains the map and data. When you refresh the web application it will pull this new data file.