lmrfdc_table: Convert an R Environment of L-moments by Annual Flow-Duration...

In wasquith-usgs/akqdecay: Many Distributional Statistics of USGS Daily Streamflow Hydrographs and Powerful Utilities

Description

Extract the raw computations from output of fdclmr and place the results into an R data.frame. This function will insert a row of NA's into the returned table of the changes from one streamgage to the next using the built-in R rbind() function. The inserted line will look something like row 6873:

            site year   n nzero           L1           L2   ... etc ...
6871   023358685 2015 365     0 1.051835e+00 2.113052e-01   ... etc ...
6872   023358685 2016 274     0           NA           NA   ... etc ...
6873        <NA>   NA  NA    NA           NA           NA   ... etc ...
6874    02335870 1984  92     0           NA           NA   ... etc ...
6875    02335870 1985 365     0 1.451423e+00 1.618747e-01   ... etc ...
   ... etc ...

By providing this NA, as shown, graphical operations on the table will be able to “lift the pen” when the successive streamgage is encountered.

Usage

lmrfdc_table(lmrfdcenv, NAline.insert=TRUE, silent=FALSE, ...)

Arguments

lmrfdcenv	A user created by fill_lmrfdcenv;
NAline.insert	A logical that can be used to suppress the NA line insertion described in the Description section;
silent	Suppress informative calls to message(); and
...	Additional arguments to pass.

Value

An R data.frame of mutable length but containing the following columns:

site	An echo of the site;
n	The number of days (values) entering into the L-moment computations;
nzero	The number of zero flow days that would not enter into L-moment computations if and only if log=TRUE;
L1	The arithmetic mean (λ_1);
L2	L-scale (λ_2);
T3	L-skew (τ_3), third L-moment ratio;
T4	L-kurtosis (τ_4), fourth L-moment ratio;
T5	Fifth unnamed L-moment ratio (τ_5), but the term L-cinco occasionally could be used; and
T6	Fifth unnamed L-moment ratio (τ_6), but the term L-seis could be used.

Note

The logic here is almost exactly that of akq_table with only differences in the last couple of lines of internal code. This is not a great design thus, but because the different themes of day-over-day changes and then statistics of the flow-duration curve, it is felt it is prudent to have separate implementations.

Author(s)

W.H. Asquith

See Also

fdclmr, fill_tfdcenv

Examples

# See Examples under fill_lmrfdcenv and elsewhere in this documentation.

wasquith-usgs/akqdecay documentation built on Nov. 9, 2020, 1:13 p.m.