Learn R Programming

lmomco (version 2.5.3)

plotlmrdia46: Plot L-moment Ratio Diagram (Tau4 and Tau6)

Description

Plot the Tau4-Tau6 L-moment ratio diagram showing trajectories of \(\tau_4\) and \(\tau_6\) for strictly symmetrical distributions from a Tau4-Tau6 L-moment ratio diagram object returned by lmrdia46. This diagram is useful for selecting among symmetrical distributions to model the data. This function is intended to function as a demonstration of Tau4-Tau6 L-moment ratio diagram plotting with enough user settings for many practical applications.

Usage

plotlmrdia46(lmr=NULL, nopoints=FALSE, nolines=FALSE,
             noaep4=FALSE,  nogld_byt5opt=TRUE, nopdq4=FALSE,  nost3=FALSE,
             nosymgdd=TRUE, nosymstable=FALSE,  notukey=FALSE,
             nocau=TRUE,    nonor=FALSE, nosla=TRUE, trucate.tau4.to.gtzero=TRUE,
             xlab="L-kurtosis (Tau4), dimensionless",
             ylab="Sixth L-moment ratio (Tau6), dimensionless",
             add=FALSE, empty=FALSE,
             autolegend=FALSE, xleg=NULL, yleg=NULL, legendcex=0.9,
             ncol=1, text.width=NULL, lwd.cex=1, expand.names=FALSE, ...)

Arguments

lmr

L-moment diagram object from lmrdia46, if NULL, then empty is internally set to TRUE.

nopoints

If TRUE then point distributions are not drawn.

nolines

If TRUE then line distributions are not drawn.

noaep4

If TRUE then the Symmetric Exponential Power distribution is not drawn.

nogld_byt5opt

If TRUE then line of Generalized Lambda distribution through it solution optimization on \(\tau_5 = 0\) is not drawn.

nopdq4

If TRUE then line of Polynomial Density-Quantile4 distribution is not drawn.

nost3

If TRUE then line of Student 3t distribution is not drawn.

nosymgdd

If TRUE then line of a symmetrical Gamma Difference distribution is not drawn.

nosymstable

If TRUE then line of Symmetric Stable distribution is not drawn.

notukey

If TRUE then line of Tukey Lambda distribution is not drawn.

nocau

If TRUE then point of Cauchy distribution (trim=1 L-moments) is not drawn.

nonor

If TRUE then point of Normal distribution is not drawn.

nosla

If TRUE then point of Slash distribution (trim=1 L-moments) is not drawn.

trucate.tau4.to.gtzero

Truncate the distributions that can extend to negative \(\tau_4\) to zero. This is a reasonable default and prevents line drawing to the left into a clipping region for easier handling of post processing of a graphic in vector editing software.

xlab

Horizonal axis label passed to xlab of the plot function.

ylab

Vertical axis label passed to ylab of the plot function.

add

A logical to toggle a call to plot to start a new plot, otherwise, just the trajectories are otherwise plotted.

empty

A logical to return before any trajectories are plotted but after the condition of the add has been evaluated.

autolegend

Generate the legend by built-in algorithm.

xleg

X-coordinate of the legend. This argument is checked for being a character versus a numeric. If it is a character, then yleg is not needed and xleg and take on “location may also be specified by setting x to a single keyword” as per the functionality of graphics::legend() itself.

yleg

Y-coordinate of the legend.

legendcex

The cex to pass to graphics::legend().

ncol

The number of columns in which to set the legend items (default is 1, which differs from legend() default of 1).

text.width

Argument of the same name for legend. Setting to 0.1 for ncol set to 2 seems to work pretty well when two columns are desired.

lwd.cex

Expansion factor on the line widths.

expand.names

Expand the distribution names in the legend.

...

Additional arguments passed into the plot() and legend() functions.

Author

W.H. Asquith

References

Asquith, W.H., 2014, Parameter estimation for the 4-parameter asymmetric exponential power distribution by the method of L-moments using R: Computational Statistics and Data Analysis, v. 71, pp. 955--970.

See Also

lmrdia46, plotlmrdia