An R Package of Hydraulic Regional Curve Relationships
Regional hydraulic dimension relationships have been produced in great
numbers since the first development of the approach by Dunne and Leopold
(1978). Although these regional relationships are in wide use, the
authors are not aware of a comprehensive compilation of regional
hydraulic dimension relationship studies into a single database that
exists as open source. The RegionalCurve
package seeks to fill that
gap by:
- Compiling regional hydraulic relationships into a single database.
- Providing assessor functions to streamline application of these relationships in other studies.
Funding for development and maintenance of FluvialGeomorph has been provided by the following US Army Corps of Engineers (USACE) programs:
- Ecosystem Management and Restoration Research Program (EMRRP).
- Regional Sediment Management Program (RSM)
- Mississippi River Geomorphology and Potamology Program (MRG&P)
- Flood Risk Management Program (FRM)
- Michael Dougherty, Geographer, U.S. Army Corps of Engineers https://orcid.org/0000-0002-1465-5927
- Christopher Haring, Fluvial Geomorphologist/Research Physical Scientist, U.S. Army Corps of Engineers
To install the RegionalCurve
package, install from GitHub using the
devtools
package:
library(devtools)
install_github(repo = "FluvialGeomorph/RegionalCurve", build_vignettes = TRUE)
View the vignettes to get started using the package.
# View the vignettes in a web browser
browseVignettes("RegionalCurve")
# Open a specific vignette in the RStudio help window
vignette("Get_Regional_Hydraulic_Dimensions")
To easily use the data in this database several assessor functions were
created to calculate an estimate of a specified hydraulic dimension for
any given drainage area. The RHG
(Regional Hydraulic Geometry)
function computes the hydraulic geometry dimension (cross sectional
area, width, depth, discharge) from a built-in data frame of regional
hydraulic equation coefficients (regional_curve
).
# Calculate the discharge for a 200 sq mi watershed in Massachusetts.
RHG(region = "MA", drainageArea = 200, dimensionType = "width")
The units of the value returned from the RHG
function will depend on
the requested dimension (see the RHG
function help for details). In
this case, the requested dimension was width
, so the units will be in
feet.
To determine which regions are available, the regional_curve
data
frame can be queried.
# Determine the available regions
levels(regional_curve$region_name)
This list of regions can be used to determine which regions are
contained in the database and the input region
string value to use for
the RHG
function.
Once you have determined which region to use, you will need to determine which dimensions that study derived a relationship for. Not all studies derive relationships for all hydraulic dimensions.
# Determine which dimensions were calculated for the Eastern United States region
regional_curve[regional_curve$region_name == "Eastern United States", c("dimension")]
As you can see, only area, width, and depth are available. Discharge was not derived by this study.
The table below lists the regional hydraulic dimension relationship studies included in this package. It lists the dimensions calculated for each regional analysis.
Region | Reference | Width | Depth | Area | Discharge |
---|---|---|---|---|---|
Altlantic Plain | Bieger et al (2015) | TRUE | TRUE | TRUE | NA |
Appalachain Highlands | Bieger et al (2015) | TRUE | TRUE | TRUE | NA |
Central and Southern AZ | Moody et al (2003) | TRUE | TRUE | TRUE | TRUE |
Eastern - Appalachian Plateau, New England, Valley and Ridge | Johnson & Fecko (2008) | TRUE | NA | NA | NA |
Eastern - Coastal Plain | Johnson & Fecko (2008) | TRUE | NA | NA | NA |
Eastern - Piedmont | Johnson & Fecko (2008) | TRUE | NA | NA | NA |
Eastern AZ/NM | Moody et al (2003) | TRUE | TRUE | TRUE | TRUE |
Eastern Highlands | Faustini et al (2009) | TRUE | NA | NA | NA |
Eastern United States | Dunne & Leopold (1978) | TRUE | TRUE | TRUE | NA |
IL River LTE 120 | Haring (2019) | TRUE | TRUE | TRUE | TRUE |
IL River LTE 300 | Haring (2019) | TRUE | TRUE | TRUE | TRUE |
IL River Panther Creek | Haring (2019) | TRUE | TRUE | TRUE | TRUE |
Illinois River | Haring (2019) | TRUE | TRUE | TRUE | TRUE |
IN Central Till Plain | Robinson (2013) | TRUE | TRUE | TRUE | NA |
IN Northern Moraine and Lake | Robinson (2013) | TRUE | TRUE | TRUE | NA |
IN Southern Hills and Lowlands | Robinson (2013) | TRUE | TRUE | TRUE | NA |
Interior Highlands | Bieger et al (2015) | TRUE | TRUE | TRUE | NA |
Interior Plains | Bieger et al (2015) | TRUE | TRUE | TRUE | NA |
Intermontane Plateau | Bieger et al (2015) | TRUE | TRUE | TRUE | NA |
KY Bluegrass | Parola et al (2007) | TRUE | TRUE | TRUE | TRUE |
Laurentian Upland | Bieger et al (2015) | TRUE | TRUE | TRUE | NA |
Lower Southern Driftless | Haring (2019) | TRUE | TRUE | TRUE | TRUE |
MA | Bent & Waite (2013) | TRUE | TRUE | TRUE | TRUE |
MD Allegheny Plateau/Valley and Ridge | McCandless (2003a) | TRUE | TRUE | TRUE | TRUE |
MD Eastern Coastal Plain | McCandless (2003b) | TRUE | TRUE | TRUE | TRUE |
MD Piedmont | McCandless & Everett (2002) | TRUE | TRUE | TRUE | TRUE |
MD Western Coastal Plain | McCandless (2003b) | TRUE | TRUE | TRUE | TRUE |
ME Coastal and Central | Dudley (2004) | TRUE | TRUE | TRUE | TRUE |
MI Southern Lower Ecoregion | Rachol & Boley-Morse (2009) | TRUE | TRUE | TRUE | TRUE |
Mid-Atlantic | Faustini et al (2009) | TRUE | NA | NA | NA |
Minnesota Eastern | MN DNR | TRUE | TRUE | TRUE | NA |
Minnesota Western | MN DNR | TRUE | TRUE | TRUE | NA |
NC Coastal Plain | Sweet & Geratz (2003) | TRUE | TRUE | TRUE | TRUE |
NC Mountains | Harman et al. (1999) | TRUE | TRUE | TRUE | TRUE |
NC Piedmont Rural | Harman et al. (1999) | TRUE | TRUE | TRUE | TRUE |
NC Piedmont Urban | Doll et al. (2002) | TRUE | TRUE | TRUE | TRUE |
New England | Faustini et al (2009) | TRUE | NA | NA | NA |
NH | Csiiki (2013) | TRUE | TRUE | TRUE | TRUE |
Northeast - Appalachian Plateau, Coastal Plain, New England, Piedmont, Valley and Ridge | Bent (2006) | TRUE | TRUE | TRUE | TRUE |
Northeast - Appalachian Plateau, New England, Piedmont, Valley and Ridge | Bent & Waite (2013) | TRUE | TRUE | TRUE | TRUE |
Northern Appalachians | Faustini et al (2009) | TRUE | NA | NA | NA |
NY Hydrologic Region 1/2 | Mulvihill et al. (2007) | TRUE | TRUE | TRUE | TRUE |
NY Hydrologic Region 3 | Mulvihill & Baldigo (2007) | TRUE | TRUE | TRUE | TRUE |
NY Hydrologic Region 4/4a | Miller & Davis (2003) | TRUE | TRUE | TRUE | TRUE |
NY Hydrologic Region 5 | Westergard et al. (2005) | TRUE | TRUE | TRUE | TRUE |
NY Hydrologic Region 6 | Mulvihill et al. (2005) | TRUE | TRUE | TRUE | TRUE |
NY Hydrologic Region 7 | Mulvihill et al. (2006) | TRUE | TRUE | TRUE | TRUE |
OH Region A | Sherwood & Huitger (2005) | TRUE | TRUE | TRUE | TRUE |
OH Region B | Sherwood & Huitger (2005) | TRUE | TRUE | TRUE | TRUE |
ON Southern | Annable (1996a, b) | TRUE | TRUE | TRUE | TRUE |
PA Carbonate Areas | Chaplin (2005) | TRUE | TRUE | TRUE | TRUE |
PA Non-Carbonate Areas | Chaplin (2005) | TRUE | TRUE | TRUE | TRUE |
PA Piedmont 1 | White (2001) | TRUE | TRUE | TRUE | TRUE |
PA Piedmont 2 | Cinotto (2003) | TRUE | TRUE | TRUE | TRUE |
Pacific Maritime Mountain | Castro & Jackson (2001) | TRUE | TRUE | TRUE | TRUE |
Pacific Mountain System | Bieger et al (2015) | TRUE | TRUE | TRUE | NA |
Pacific Northwest | Castro & Jackson (2001) | TRUE | TRUE | TRUE | TRUE |
Rocky Mountain System | Bieger et al (2015) | TRUE | TRUE | TRUE | NA |
San Francisco Bay | Dunne & Leopold (1978) | TRUE | TRUE | TRUE | NA |
Southern Appalachians | Faustini et al (2009) | TRUE | NA | NA | NA |
Southern Driftless | Haring (2019) | TRUE | TRUE | TRUE | TRUE |
Upper Green River | Dunne & Leopold (1978) | TRUE | TRUE | TRUE | NA |
Upper Salmon River | Dunne & Leopold (1978) | TRUE | TRUE | TRUE | NA |
USA | Bieger et al (2015) | TRUE | TRUE | TRUE | NA |
VA Piedmont | Lotspeich (2009) | TRUE | TRUE | TRUE | TRUE |
VA, MD Coastal Plain | Kristolic & Chaplin (2007) | TRUE | TRUE | TRUE | TRUE |
VA, MD, WV Valley and Ridge | Keaton et al (2005) | TRUE | TRUE | TRUE | TRUE |
VT | Jaquith & Kline (2001) | TRUE | TRUE | TRUE | TRUE |
West Interior Basin and Range | Castro & Jackson (2001) | TRUE | TRUE | TRUE | TRUE |
Western Cordillera | Castro & Jackson (2001) | TRUE | TRUE | TRUE | TRUE |
WV Appalachian Plateau | Messinger (2009) | TRUE | TRUE | TRUE | TRUE |
WV Eastern Valley and Ridge | Messinger &Wiley (2004) | TRUE | TRUE | TRUE | NA |
WV Western Appalachian Plateau | Messinger &Wiley (2004) | TRUE | TRUE | TRUE | NA |