This repo contains code to work with USDR's UNIVAF appointment data, and some analysis done using this data.
The data processing code is written in Python 3. The pipeliness for UNIVAF and VaccineSpotter are very similar, but slightly different. In either case, the code downloads the raw data files if necessary, processes them day by day, and aggregates records to combine intervals that span more than a day. Raw data is stored in ./data/{SOURCE}_raw/ and processed data in ./data/{SOURCE}_clean/.
The intstructions for how to run the scrips are included in each script respectively, but the general format is the same:
python process_{SOURCE}.py -s {START_DATE} -e {END_DATE}
One major difference is how locations are processed. UNIVAF maintains a separate database for provider locations, so the last file is always the one to use. For VaccineSpotter, the location information comes from the availability records, so we maintain a location database that gets updated every time a new row comes in.
The analysis code lives in ./reports and is all written in R/RMarkdown. Here is a list of libraries to install to reproduce everything:
install.packages(c('tidyverse', 'scales', 'lubridate', 'rgdal', 'broom', 'maptools'))
Each report is checked-in as the .Rmd file containing the source code, and the .html file which has the rendered content. To reproduce everything, you can re-knit the .Rmd reports from RStudio or from the command line like so:
Rscript -e "rmarkdown::render('./reports/state_AK.Rmd')"
Here is an index of the rendered analyses:
- Coverage
- State reports:
- Univaf Sandbox
- VaccineSpotter Sandbox
- Content for blogpost - published here
This repository falls under U.S. Digital Response’s Code of Conduct, and we will hold all participants in issues, pull requests, discussions, and other spaces related to this project to that Code of Conduct. Please see CODE_OF_CONDUCT.md for the full code.
This project is open source, and we welcome any bug fixes or new features. Please see CONTRIBUTING.md to find out how you can help.
Lead Maintainer: @janovergoor
Copyright (C) 2021 U.S. Digital Response (USDR)
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License. You may obtain a copy of the License at:
LICENSE in this repository or http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.