ErosionTransectsUtilMangrove: Erosion Transects Utility Mangrove

View source: R/ErosionTransectsUtilMangrove.R

ErosionTransectsUtilMangroveR Documentation

Erosion Transects Utility Mangrove

Description

Mudflat erosion model originally developed by Dr. Greg Guannel for the Coastal Natural Capital InVEST project. This function estimates beach retreat and wave runup for mangrove mudflats.

Usage

ErosionTransectsUtilMangrove(
  Ho = 2.5,
  To = 7,
  total_wsl_adj = NA,
  linkbeach = NA,
  wave_data = NA,
  storm_duration = 3,
  Longshore = 100,
  PropValue = 200,
  Tr = 10,
  disc = 0.05,
  TimeHoriz = 50,
  mean_sea_level = 0.01,
  mean_high_water = 0.7
)

Arguments

Ho

Initial offshore wave height in meters.

To

Initial offshore wave period in seconds.

total_wsl_adj

Total water surface level above the chart datum. Recall that the chart datum and TopoBathy DEM are referenced to have 0 at low water. It is recommended that the erosion model is run with mean sea level.

linkbeach

Dataframe returned from LinkProfilesToBerms. Should contain. columns for forshore slope 'fore_slp', Erosion Constant 'me' in kg/Ns and density 'Cm' in km/m3.

wave_data

sf and dataframe spatial points returned from WaveModel.

storm_duration

Numeric. Storm duration in hours.

Longshore

Longshore distance in meters should match ShorelinePointDist used in samplePoints.

PropValue

Generally land value in dollars per square meter of beach. (not used if beach polygon property values are provided).

Tr

Numeric. Return period (frequency) of the simulated storm (in years).

disc

Annual valuation discount rate over the time horizon (0 - 1).

TimeHoriz

Time horizon (in years) for long term cumulative valuation given a storm return frequency. Typically 100-year horizons are used.

mean_sea_level

Mean sea level elevation in meters above chart datum. Note that the chart datum should be adjusted to LLW for these estimates

mean_high_water

Mean high water level elevation in meters above chart datum.

Details

The coastal erosion model was originally developed by Dr. Greg Guannel for the Coastal Natural Capital InVEST project. This function estimates lateral beach erosion and wave runup for each cross-shore profile. Foreshore parameters for berm width, height etc. are provided as spatial polygons for each beach section. These are then linked to underlying cross-shore profiles for erosion estimates. The return object is a data frame showing erosion estimates for each cross-shore profile.

Value

A data frame with erosion estimates for each cross-shore profile. _NoVeg is estimated without submerged vegetation and _Veg is an estimate with submerged vegetation

References

InVEST: Wave Attenuation & Erosion Reduction: Coastal Protection (G. Guannel)

Guannel et al. (2014) Integrated modeling framework to quantify the coastal protection services supplied by vegetation. Journal of Geophysical Research: Oceans. DOI: 10.1002/2014JC009821.


essatech/MNAI.CPBT documentation built on July 1, 2023, 12:34 p.m.