CCRP Climate Futures Creation

Contact Amber Runyon prior to reuse of code for appropriate citation

Added Koppen.Rmd to master branch to enable running off of modified plotting scripts

Instructions for running CCRP_Climate_Futures.Rmd

Maintained by: Climate Change Response Program

This script was created using R version >= 4.0.2 and RStudio version >= 1.3.1056 These instructions assume the user has already connected RStudio to GitHub and has access to the nationalparkservice/CCRP_Climate_Futures repo

Step 1. Clone CCRP_Climate_Futures into your local repository folder and connect to RStudio

- In RStudio, click on File --> New Project. Select 'Version Control' and then 'Git'.
- Enter the URL for the repo. Connect using SSH. [CCRP_Climate_Futures] (git@github.com:nationalparkservice/CCRP_Climate_Futures.git)
- Enter the name of the repo for the Project directory name (CCRP_Climate_Futures)
- Create the project as a subdirectory of the local folder in which you store your respositories (example: ~/Documents/Repos)
- Select Create Project. 
- In the lower right window of RStudio, you should see the files and folders from the repo under the 'Files' tab. 
    - These should be the same files and folders found on 

CCRP_Climate_Futures

Step 2: Leave RStudio and use File Explorer to add spatial data to the './data/general' folder

A note on file structure: The notation './' is used to refer to the project root directory. This is where your .RProj file is located.

*A zipped folder of spatial data is located at CCRP_Climate_Futures_Data

File names must be spelled exactly as they are written here or the scripts will not work. The notation '/' refers to a folder with multiple files (i.e. the .shp, .dbf, .prj etc. that comprise an ESRI shapefile)

Spatial data only has to be added one time for all parks in the continental US. Once you add the files to your spatial-data folder, you should not have to do it again.

- Create the following subfolder within the './data/general' folder:

    - spatial-data ('./data/general/spatial-data') 
    
- Place the following files in the new spatial-data folder:

        - water_storage.tif 
        - elevation_cropped.tif
        - /US_Counties 
        - /State_Shapefile
        - /nps_boundary
        - /nps_boundary_centroids
        - /Climate_grid
        
 - Make sure your new files and folders do not appear beneath the 'Git' tab

Step 3: Run the script!

- Enter park data and all parameters into the user-input chunk in the .Rmd script
- Run the script! Select Run --> Run All or press Ctrl+Alt+R
- The script will create all the necessary files and folders from here on out. 

End instructions for running CCRP_Climate_Futures.Rmd

The following describes the set of functions to parse historical (NOAA and GridMET) data and CMIP5 (MACA) projections, create data tables, and plot visualizations.

1. Historical trends

- Scripts for parsing NOAA and Gridmet data; script for plotting NOAA data

2. Climate Futures

- Script for parsing MACA; script for parsin GridMET; Plot table creation; scatterplots and diagnostics; plotting bar charts

3. Water balance (package in own repository)

- Daily water balance

4. Summary plots

- Summary plots (bias-corrected timeseries for temp and precip)
- Summary WB (bias-corrected, run WB (monthly) for all GCMs in CFs; plot timeseries)

5. Additional tables and plots (these include scripts for plots that are regionally specific as well as query of Audubon results).

- Drought plots - work with any park, but will mostly be used in western parks
- Forest vulnerability - (FLI FBI plots) - These only cover eastern parks
- Audubon - most parks included