regsamlmu function

Sample L-moments of multiple data sets

Sample L-moments of multiple data sets

Computes the unbiased sample LL-moments and LL-moment ratios of multiple sets of data stored in a list or matrix. Following the paradigm of regional frequency analysis, we regard the data sets as coming from different measurement sites.

regsamlmu(x, nmom = 5, sort.data = TRUE, lcv = TRUE)

Arguments

  • x: A list of numeric vectors, or a numeric matrix.
  • nmom: Number of LL-moments to be computed.
  • sort.data: Logical: whether each data set should be sorted.
  • lcv: Logical. If TRUE, the second LL-moment will be expressed as a fraction of the mean, i.e. the computed value will be the sample LL-CV t=l2/l1t=l_2/l_1. If FALSE, the second LL-moment will simply be the sample LL-scale value l2l_2.

Details

Sample LL-moments are computed for each data set. The calculations use samlmu internally. If x is a list, each list element should contain data for one site and the names of the list elements should be the site names. If x is a matrix, each column should contain data for one site and the column names should be the site names.

Returns

An object of class regdata. It is a data frame with columns "name" and "n", containing respectively the site names and the number of non-missing data values at each site, and further columns containing the LL-moments and LL-moment ratios, in the order l1l_1, tt (or l2l_2), t3t_3, t4t_4, etc.

Note

The default parameter values are chosen to be convenient for the regional frequency analysis methods described by Hosking and Wallis (1997). Note that the number of LL-moments and the choice of whether to return LL-CV or LL-scale are different from the defaults for samlmu.

Users of the LMOMENTS Fortran package, version 3.04, should note that its PROGRAM XFIT by default uses plotting-position estimators of LL-moment ratios, which give different results from the unbiased estimators used by regsamlmu

(and by all other functions in package lmomRFA).

References

Hosking, J. R. M., and Wallis, J. R. (1997). Regional frequency analysis: an approach based on LL-moments. Cambridge University Press.

Author(s)

J. R. M. Hosking jrmhosking@gmail.com

Examples

data(Maxwind) # a list regsamlmu(Maxwind) data(airquality) # a data frame regsamlmu(airquality[1:4])
  • Maintainer: J. R. M. Hosking
  • License: Common Public License Version 1.0
  • Last published: 2024-09-30

Useful links