Learn R Programming

lmomco (version 0.88)

pargld: Estimate the Parameters of the Generalized Lambda Distribution

Description

This function estimates the parameters of the Generalized Lambda distribution given the L-moments of the data in an ordinary L-moment object (lmom.ub or a trimmed L-moment object (TLmoms for t=1. The relation between distribution parameters and L-moments is seen under lmomgld. There are no simple expressions for the parameters in terms of the L-moments. This function is considered HIGHLY EXPERIMENTAL and general details of the algorithm are provided below. Further, consider that multiple parameter solutions are possible with the Generalized Lambda so some expertise in the distribution and other aspects are needed.

Usage

pargld(lmom,result='best',verbose=FALSE,extract=0,initkh=NULL)

Arguments

lmom
A L-moment object created by lmom.ub, pwm2lmom, or TLmoms with trim=0.
result
If best, then the minimum error solution is returned. If dataframe, then data.frame is returned with sequence of valid solutions sorted in ascending error order.
verbose
A logical switch on the verbosity of output. Default is verbose=FALSE.
extract
If result=dataframe and extract greater than zero, then the extract=n returns the nth element of the data.frame as if that element was the best solution.
initkh
A vector of the initial guess of the $\kappa$ and $h$ parameters. No other regions of parameter space are consulted.

Value

  • An R list is returned if result='best'.
  • typeThe type of distribution: gld.
  • paraThe parameters of the distribution.
  • errorSmallest sum of square error found.
  • tau5diffDifference between $\hat{\tau}_5$ and the $\tilde{\tau}_5$ of the fitted distribution.
  • sourceThe source of the parameters: pargld.
  • An R data.frame is returned if result='dataframe', which is sorted by ascending error.
  • attemptThe attempt number that found valid L-moments and parameters of GLD.
  • xThe location parameter of the distribution.
  • aThe scale parameter of the distribution.
  • kThe 1st shape parameter of the distribution.
  • hThe 2nd shape parameter of the distribution.
  • tau5_diffThe absolute difference between $\hat{\tau}_5$ of data to $\tilde{\tau}_5$ of the fitted distribution.
  • errorThe sum of square error found.
  • initial_kThe starting point of the $\kappa$ parameter.
  • initial_hThe starting point of the $h$ parameter.

source

R hacking by W.H. Asquith in February 2006 with copy of Karian and Dudewicz (2000).

Details

Karian and Dudewicz (2000) summarize six regions of the $\kappa$ and $h$ space in which the Generalized Lambda distribution is valid for suitably choosen $\alpha$. Numerical experimentation suggestions that the L-moments are not valid in Regions 1 and 2. However, initial guesses of the parameters within each region are used for numerous separate optim (the R function) efforts to perform a least sum-of-square errors on the following objective function.

$$(\hat{\tau}_3 - \tilde{\tau}_3)^2 + (\hat{\tau}_4 - \tilde{\tau}_4)^2 \mbox{, }$$

where $\hat{\tau}_r$ is the L-moment ratio of the data, $\tilde{\tau}_r$ is the estimated value of the L-moment ratio for the fitted distribution $\kappa$ and $h$ and $\tau_r$ is the actual value of the L-moment ratio.

For each optimization a check on the validity of the parameters so produced is made--are the parameters consistent with the Generalized Lambda distribution and a second check is made on the validity of $\tau_3$ and $\tau_4$. If both validity checks return TRUE then the optimization is retained if its sum-of-square error is less than the previous optimum value. It is possible for a given solution to be found outside the starting region of the initial guesses. The surface generated by the $\tau_3$ and $\tau_4$ equations seen in lmomgld is complex--different initial guesses within a given region can yield what appear to be radically different $\kappa$ and $h$. Users are encouraged to play with alternative solutions (see the verbose argument). A quick double check on the L-moments from the solved parameters using lmomgld is encouraged as well. Karvanen and others (2002, eq. 25) provide an equation expressing $\kappa$ and $h$ as equal (a symmetrical Generalized Lambda distribution) in terms of $\tau_4$ and suggest that the equation be used to determine initial values for the parameters. This equation is used on an experimental basis for the final optimization attempt by this function.

References

Karvanen, J., Eriksson, J., and Koivunen, V., 2002, Adaptive score functions for maximum likelihood ICA: Journal of VLSI Signal Processing, vol. 32, p. 82--92.

Karian, Z.A., and Dudewicz, E.J., 2000, Fitting statistical distributions---The generalized lambda distribution and generalized bootstrap methods: CRC Press, Boca Raton, FL, 438 p.

See Also

lmom.ub, lmomgld, cdfgld, quagld, parTLgld

Examples

Run this code
lmr1 <- lmom.ub(rnorm(200))
P <- pargld(lmr1)
lmr2 <- lmomgld(P)

Run the code above in your browser using DataLab