RecordTest (version 2.0.0)

L.plot: Times of Record Plot

Description

This function builds a ggplot object to display the upper and lower record times for both forward and backward directions.

Usage

L.plot(
  X,
  all = TRUE,
  record = c("upper", "lower"),
  point.col = "gray23",
  point.alpha = 0.8,
  line.col = "gray95"
)

Arguments

X

A numeric vector, matrix (or data frame).

all

Logical. If TRUE (the default) the four types of record are displayed.

record

If all = FALSE, a character string indicating the type of record to be calculated, "upper" or "lower".

point.col, point.alpha

Color and transparency of the points.

line.col

Color to plot lines.

Value

A ggplot object.

Details

The function can be applied to plot the record times in a vector (if argument X is a vector) or to plot and compare the record times in a set of vectors (if argument X is a matrix). In the latter case, the approach to obtain the record times is applied to each column of the matrix.

If all = TRUE, a matrix of four panels is displayed for upper and lower records, and for the forward and backward (series_rev) directions. Otherwise, only one type of forward record is displayed.

An example of use of a plot with similar ideas is shown in Benestad (2004, Figures 3 and 8).

References

Benestad RE (2004). <U+201C>Record-Values, Nonstationarity Tests and Extreme Value Distributions.<U+201D> Global and Planetary Change, 44(1-4), 11-26.

See Also

L.record

Examples

# NOT RUN {
Y <- c(1, 5, 3, 6, 6, 9, 2, 11, 17, 8)
L.plot(Y, all = FALSE)

L.plot(ZaragozaSeries, point.col = 1)

# }