README.md

In mpdougherty/RegionalCurve: A Collection of Hydraulic Regional Curve Relationships

RegionalCurve

An R Package of Hydraulic Regional Curve Relationships

Package Status

Need

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

Funding for development and maintenance of RegionalCurve was provided by the US Army Corps of Engineers (USACE) Ecosystem Management and Restoration Research Program (EMRRP).

Authors

• Michael Dougherty, Geographer, U.S. Army Corps of Engineers
• Christopher Haring, Fluvial Geomorphologist/Research Physical Scientist, U.S. Army Corps of Engineers

Install

To install the RegionalCurve package, install from GitHub using the devtools package:

library(devtools)
install_github(repo = "mpdougherty/RegionalCurve", build_vignettes = TRUE)

Vignettes

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")

Calculating Hyrdaulic 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")
#> [1] 127.7779

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)
#>  [1] "Central and Southern AZ"                                                                
#>  [2] "Eastern - Appalachian Plateau, New England, Valley and Ridge"                           
#>  [3] "Eastern - Coastal Plain"                                                                
#>  [4] "Eastern - Piedmont"                                                                     
#>  [5] "Eastern AZ/NM"                                                                          
#>  [6] "Eastern Highlands"                                                                      
#>  [7] "Eastern United States"                                                                  
#>  [8] "IL River LTE 120"                                                                       
#>  [9] "IL River LTE 300"                                                                       
#> [10] "IL River Panther Creek"                                                                 
#> [11] "Illinois River"                                                                         
#> [12] "IN Central Till Plain"                                                                  
#> [13] "IN Northern Moraine and Lake"                                                           
#> [14] "IN Southern Hills and Lowlands"                                                         
#> [15] "Lower Southern Driftless"                                                               
#> [16] "MA"                                                                                     
#> [17] "MD Allegheny Plateau/Valley and Ridge"                                                  
#> [18] "MD Eastern Coastal Plain"                                                               
#> [19] "MD Piedmont"                                                                            
#> [20] "MD Western Coastal Plain"                                                               
#> [21] "ME Coastal and Central"                                                                 
#> [22] "MI Southern Lower Ecoregion"                                                            
#> [23] "Mid-Atlantic"                                                                           
#> [24] "Minnesota Eastern"                                                                      
#> [25] "Minnesota Western"                                                                      
#> [26] "NC Coastal Plain"                                                                       
#> [27] "NC Mountains"                                                                           
#> [28] "NC Piedmont Rural"                                                                      
#> [29] "NC Piedmont Urban"                                                                      
#> [30] "New England"                                                                            
#> [31] "NH"                                                                                     
#> [32] "Northeast - Appalachian Plateau, Coastal Plain, New England, Piedmont, Valley and Ridge"
#> [33] "Northeast - Appalachian Plateau, New England, Piedmont, Valley and Ridge"               
#> [34] "Northern Appalachians"                                                                  
#> [35] "NY Hydrologic Region 1/2"                                                               
#> [36] "NY Hydrologic Region 3"                                                                 
#> [37] "NY Hydrologic Region 4/4a"                                                              
#> [38] "NY Hydrologic Region 5"                                                                 
#> [39] "NY Hydrologic Region 6"                                                                 
#> [40] "NY Hydrologic Region 7"                                                                 
#> [41] "OH Region A"                                                                            
#> [42] "OH Region B"                                                                            
#> [43] "ON Southern"                                                                            
#> [44] "PA Carbonate Areas"                                                                     
#> [45] "PA Non-Carbonate Areas"                                                                 
#> [46] "PA Piedmont 1"                                                                          
#> [47] "PA Piedmont 2"                                                                          
#> [48] "Pacific Maritime Mountain"                                                              
#> [49] "Pacific Northwest"                                                                      
#> [50] "San Francisco Bay"                                                                      
#> [51] "Southern Appalachians"                                                                  
#> [52] "Southern Driftless"                                                                     
#> [53] "Upper Green River"                                                                      
#> [54] "Upper Salmon River"                                                                     
#> [55] "VA Piedmont"                                                                            
#> [56] "VA, MD Coastal Plain"                                                                   
#> [57] "VA, MD, WV Valley and Ridge"                                                            
#> [58] "VT"                                                                                     
#> [59] "West Interior Basin and Range"                                                          
#> [60] "Western Cordillera"                                                                     
#> [61] "WV Appalachian Plateau"                                                                 
#> [62] "WV Eastern Valley and Ridge"                                                            
#> [63] "WV Western Appalachian Plateau"

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")]
#> [1] area  width depth
#> Levels: area depth discharge width

As you can see, only area, width, and depth are available. Discharge was not derived by this study.

Regional Analyses Contained in this Database

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 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 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 Northwest Castro & Jackson (2001) TRUE TRUE TRUE TRUE 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 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

mpdougherty/RegionalCurve documentation built on Nov. 21, 2019, 8:45 p.m.