Package 'dartx'

Title: Applies Drainage Area Ratio Method With Correction Factors
Description: Applies empircally derived parameters for drainage area ratio calculated streamflows in Texas.
Authors: Michal Schramm [aut, cre]
Maintainer: Michal Schramm <[email protected]>
License: GPL-3
Version: 0.1.0
Built: 2024-10-06 02:47:20 UTC
Source: https://github.com/mps9506/dartx

Help Index


Applies Correction Factor to Drainage Area Ratio Calculated Streamflows

Description

Streamflows estimated using the drainage-area ratio method are typically over- or under-estimated at the tails of the streamflow distribution. Asquith, Roussel, and Vrabel (2006) provide empirically-derived correction factors for estimating streamflows in Texas using the drainage-area ratio method. Applying this function to a dataframe of streamflows will return a dataframe with the original streamflow, the non-exceedance probability (cume_dist), the correction factor used (exp), and the estimated streamflow (Q).

Usage

dartx(.data, flow, dar, defaultPhi = TRUE, ...)

Arguments

.data

table of class data.frame with at least one column with streamflows

flow

Variable specifying streamflows in df

dar

numeric, drainage area ratio to be applied

defaultPhi

logical. Defaults to TRUE. Use TRUE to apply values reccomended by Asquith et. al. If FALSE provide a dataframe with derived values of phi as a dataframe with the following variables: min, max, exp. Where min and max are the range of percentile values to apply the value of phi and exp is the value of phi to be applied.

...

optional arguments. If defaultPhi = TRUE, expects a dataframe supplied for the argument customPhi.

Details

The drainage area ratio is an algebraic method for estimating same-day streamflows from one location to another on the basis the the ratio of the drainage areas are the same as the ratio of the streamflow. The typical equation is:

Y=X(AyAx)ϕY = X\left ( \frac{A_y}{A_x} \right )^{\phi}

Where YY is the streamflow at the ungaged site, XX is the streamflow at the gaged site, AyA_y and AxA_x are drainage areas of YY and XX. Often, ϕ\phi is assumed equal to one.

Asquith, Roussel, and Vrabel (2006) developed empirically derived values of ϕ\phi based on streamflow percentiles (non-exceedance probability) for 54 percentiles of daily mean streamflow in Texas. Values of ϕ\phi range from 0.700 to 0.935.

Value

dataframe with new variables: Q_percentile, exp and Q. Where Q_percentile are the non-exceedance probability, exp are the values of phi applied to the DAR calculation and Q is the DAR estimated flow value.

References

Asquith, William H., Meghan C. Roussel, and Joseph Vrabel. 2006. “Statewide Analysis of the Drainage-Area Ratio Method for 34 Streamflow Percentile Ranges in Texas.” 2006–5286. U.S. Geological Survey Scientfic Investigations Report. U.S. Geological Survey. https://pubs.usgs.gov/sir/2006/5286/pdf/sir2006-5286.pdf.


Exponent values for streamflow estimation

Description

Mean values of phi per quartile for stations < 100 miles apart and absolute value of the logarithim of the ratio fo the drainage areas >= 0.25. Included mainly to demonstrate how to use custom Phi values.

Usage

quartilePhi

Format

A data frame with four rows and three variables:

min

minimum of the range of streamflow percentile values that exp is used for

max

minimum of the range of streamflow percentile values that exp is used for

exp

estimated values of the exponent parameter to apply to the drainage area ratio

Source

Asquith, William H., Meghan C. Roussel, and Joseph Vrabel. 2006. “Statewide Analysis of the Drainage-Area Ratio Method for 34 Streamflow Percentile Ranges in Texas.” 2006–5286. U.S. Geological Survey Scientfic Investigations Report. U.S. Geological Survey.