Authors: Grant McKown (james.mckown@unh.edu), Jennifer Gibson (jennifer.gibson@unh.edu)
Organization: Coastal Habitat Restoration Team, Jackson Estuarine Laboratory, University of New Hampshire
Purpose:
The R package was created to expedite the analysis of tidal water elevation - time series data by caluclating common tidal hydrology metrics (mean low tide, high tide, etc.) and flooding parameters for given elevations of the salt marsh surface (flooding duration, high tide fooding frequency, etc.) across numerous water level recorders for a given site. Additionally, the code graphs the tidal hydrology for an individual water level recorder and its associated creek water level recorder.
Any user is free (and encouraged!) to download and use the R project. Note of Warning - the code may be updated from time to time to ensure compatibility with R package updates and enhance capabilities.
Notes on Monitoring Design and Code Compatibility:
The R code is specifically written to meet the hydrology monitoring protocols of the Coastal Habitat Restoration Team. In a given area of salt marsh, two types of water level recorders are deployed simultaneously: Creek and Groundwater/Pool WLRs. The creek WLRs are deployed in ditches or creeks to monitor the site-level tidal hydrology. The groundwater and pool WLRs are placed in PVC piezometers and set 50 - 60 cm belowground with the specific aim of monitoring the changes in groundwater at specific locations. The Coastal Habitat Restoration Team conducts monitoring of salt marsh restoration projects in a BACI design where there is one WLR in the creek, one in the impacted or restored marsh, one in a 'pristine' reference marsh, and one in a degraded no action marsh. The basic requirements for the monitoring design (and R Code) is to have at least one creek WLR and one groundwater/pool WLR.
However, if your monitoring design does not include groundwater WLRs nor pertain to a restoration monitoring project, good news! All you need to use is Scripts 1 (data formatting), 2 (creek hydrology), and 5 (graphing) and simply skip over scripts 3 and 4.
Overall, the code is standardized to accomodate different monitoring strategies and combinations of creek and groundwater WLRs. As long as the input data is in the correct format, it should work!
Project Overview:
A brief description of the five R code scripts is provided below. Please note that each R script is heavily annotated to explain analysis steps, reasonings for certain steps, and explaination of crucial functions.
-
Format Dataset - R script formats the water level elevation - time series dataset to allow for use in the rest of the R scripts
-
Creeks - R script calculates mean low tide, high tide, higher high tide, and maximum tide elevation for each creek WLR in the formatted time series dataset
-
Groundwater & Pools - R script calculates tidal hydrology metrics (see Creeks R script) for each non-creek WLR. Additionally, the script calculates the flooding duration (% of monitoring time), high tide flooding frequency (%), and the mean drainage elevation for each low tide for given marsh platform and root zone elevations
-
Sparrow Islands - R script calculates the flooding metrics (see Groundwater & Pools script) for given elevations of constructed sparrow islands according to the nearest creek WLR.
-
Graphing Tidal Elevations - R script graphs the water elevations of a single groundwater/pool WLR and its associated creek WLR. The elevations of the marsh platform, root zone, and associated constructed sparrow islands are also graphed.
Folders:
See individual README files in each folder for more in-depth details.
-
Input Data - folder the user of the R project will need to deposit the necessary datasets. See the folder README for in-depth details on the dataset needs for the R scripts. Example datasets are provided in the folder. R script is currently written to run with the example datasets.
-
Dataset Templates - blank CSV files with appropriate column headers (and blank cells) for the needed input datasets
-
Formatted Datasets - an intermediary folder that holds various water level elevation datasets that are created in one R script and utilized in the another R script'
-
Output Stats - destination of finalized tables for the descriptive statistics of tidal hydrology of creek, groundwater, and pool water level recorders and flooding for groundwater level recoders and constructed sparrow islands.
-
Figures - output of water level tidal elevation graphs in JPG format