04-solution-design.Rmd

# Summary of Solution Design

## Glossary and Definitions

Throughout this document we define “reservable sites” as traditional campgrounds, single remote campsites, overnight boat-in sites or mooring, equestrian sites, cabins, and other shelters listed in the [RIDB data](https://ridb.recreation.gov/).

A full glossary can be found in the [Appendix Section][Glossary Table].

## Access, Clean, and Wrangle Data

[RIDB data](https://ridb.recreation.gov/) and [US Census American Communities Survey (ACS) data](https://www.census.gov/programs-surveys/acs/data.html) are freely available online to the public. We accessed, cleaned, and wrangled all data outside of the [Outdoor Equity App](https://shinyapps.bren.ucsb.edu/oe_app/) using the `data_wrangle_and_clean.Rmd` document and 18 custom-made functions (Appendix Table \@ref(tab:func-table1)). We downloaded RIDB data in CSV format from Recreation.gov and ACS data through API using the R package `tidycensus` [@R-tidycensus]. We first subsetted RIDB and ACS datasets to include only the variables relevant to our objectives. We then normalized, aggregated, and calculated variables as necessary. Once both datasets are cleaned and wrangled, we joined them using ZIP codes as the key (common value in both datasets). Finally we wrangled the joined RIDB and ACS dataset to ready them for creating data relationship plots.

See the [Appendix Section][Functions Table] for a full table of all functions.


## Analysis and Visualizations

The [Outdoor Equity App](https://shinyapps.bren.ucsb.edu/oe_app/) features interactive maps and plots. Users of this app can select a single reservable site to create custom plots that show a data summary of a single variable or a data relationship between two variables. Visualizations of multiple reservable sites appear as separate plots. Users can also select a single site to create a visitorshed map for the full United States and for the state in which the site is located. 


## Outdoor Equity App

The app has a navigation bar with four tabs: About, Analysis, Metadata and Data Download. Nested under the Analysis tab are the subtabs of Data Summary, Data Relationship, and Visitorshed Maps. The app opens automatically to the About tab. 

```{r, app-screenshot1, echo=FALSE, fig.cap = "Screenshot of the About page of the Outdoor Equity App", fig.height=10}
knitr::include_graphics("images/screenshot_about.png", dpi = 275)
```

```{r, app-screenshot2, echo=FALSE, fig.cap = "Screenshot of the Analysis page of the Outdoor Equity App"}
knitr::include_graphics("images/screenshot_data-summary.png", dpi = 275)
```

```{r, app-screenshot3, echo=FALSE, fig.cap = "Screenshot of the Analysis page of the Outdoor Equity App"}
knitr::include_graphics("images/screenshot_data-relationship.png", dpi = 275)
```

```{r, app-screenshot4, echo=FALSE, fig.cap = "Screenshot of the Analysis page of the Outdoor Equity App"}
knitr::include_graphics("images/screenshot_visitorshed.png", dpi = 275)
```

```{r, app-screenshot5, echo=FALSE, fig.cap = "Screenshot of the Metadata page of the Outdoor Equity App"}
knitr::include_graphics("images/screenshot_metadata.png", dpi = 275)
```

```{r, app-screenshot6, echo=FALSE, fig.cap = "Screenshot of the Metadata page of the Outdoor Equity App"}
knitr::include_graphics("images/screenshot_data-download.png", dpi = 275)
```


## User Guide and Technical Documentation

The [Outdoor Equity App](https://shinyapps.bren.ucsb.edu/oe_app/) includes a user guide and metadata information. The user guide section includes a quick overview of the app and helper text on how to start creating visuals. 

This technical documentation is created with the `bookdown` package [@R-bookdown] and is linked in the About tab of the Outdoor Equity App. Metadata for all variables used within the app are also available on the app Metadata tab and in the [Products and Deliverables Section][Products and Deliverables] of this document.