- Programmers: Joshua Eagan, Max Griswald
- Created Date: 10/12/2023
This repository contains code used to create policy wheel data visualizations as seen in OPTIC (Opioid Policy Tools and Information Center) publications, e.g. Pessar, 2021 and Davis, 2024.
- demo.Rmd - This R Markdown tutorial demonstrates how to create policy wheel data visualizations.
- setup_example_data.R - This script was used to create the input data for demo.Rmd. The output from this file is included in this repo for convenience, so this does not need to be rerun.
- R/make_policy_wheel.R - This program creates policy wheel data visualizations with custom user data
- R/plot_policy_wheel_internal.R - This function is not called by the user directly- it is called "under the hood" of
make_policy_wheeland creates the circular shell for each individual policy wheel. - R/fill_in_cells.R - This is called by
plot_policy_wheel_internal.R, not directly by the user. It takes the user data and fills each cell of the policy wheel according to the dates policies were enacted.
To reproduce the demo, follow these steps:
- Pull this repository to your machine using git pull or by clicking the green drop down button that says code on this page, selecting
Download ZIP, and unzipping that file somewhere on your computer. - Make sure a modern version of R and R Studio are installed on your computer (we used
R version 4.4.0). - Make sure to have the proper toolchain installed: linux: GCC and GNU Make, mac: xcode, windows: rtools. Run
Sys.which("make")from R to check that this was successful (if so, the path to the make executable will be returned.) - Launch R Studio, and open the
policy_wheels.Rprojin the repository you obtained in step 1. You can do this by navigating tofile,open file, and double clicking on the project in RStudio's file explorer. - Run the line
renv::restore()in the console (lower left hand corner of R studio). This installs some software dependencies. Follow the instructions in the console until this is finished running. If this fails, try updating R and R Studio (selecting all the default settings) and double check that you have the proper toolchain installed (step 4). - Open the
demo.Rmdfile- run this file from start to finish by pressing the knit button or (ctrl + shift + k)
If you wish to reproduce the input data for the demo:
- Go through steps 1-5 above if you haven't already.
- Download the zip files from each of the following URLs to the Data/raw folder of the repository your just downloaded. Unzip them into Data/raw- they should be named correctly by default.
- https://www.rand.org/content/dam/rand/pubs/external_publications/EP60000/EP68648/RAND_EP68648-OBBT.zip
- https://www.rand.org/content/dam/rand/pubs/external_publications/EP60000/EP69157/RAND_EP69157-IMD.zip
- https://www.rand.org/content/dam/rand/pubs/external_publications/EP60000/EP68090/RAND_EP68090-NAL.zip
- https://www.rand.org/content/dam/rand/pubs/external_publications/EP60000/EP68218/RAND_EP68218-GSL.zip
- https://www.rand.org/content/dam/rand/pubs/external_publications/EP60000/EP68090/RAND_EP68090_Coprescrib-NAL.zip
- https://www.rand.org/content/dam/rand/pubs/external_publications/EP60000/EP68218/RAND_EP68218-PDMP.zip
- https://www.rand.org/content/dam/rand/pubs/external_publications/EP60000/EP67480/RAND_EP67480-MMPD.zip
- Open the file
setup_example_data.R, and run that file from start to finish. This creates the data used in the demo.
- Pessar, Seema Choksy, Anne Boustead, Yimin Ge, Rosanna Smart, and Rosalie Liccardo Pacula. “Assessment of State and Federal Health Policies for Opioid Use Disorder Treatment During the COVID-19 Pandemic and Beyond.” JAMA Health Forum 2, no. 11 (November 2021): e213833. https://doi.org/10.1001/jamahealthforum.2021.3833.
- Davis, Corey S., Derek H. Carr, and Bradley D. Stein. “Drug-Related Physician Continuing Medical Education Requirements, 2010–2020.” Journal of Substance Use and Addiction Treatment 161 (2024): 209356. https://doi.org/10.1016/j.josat.2024.209356.
Copyright (C) 2024 RAND Corporation. This code is made available under the GPL-v3 license.