RecordTest (version 2.0.0)

R.record: Record Values

Description

Returns the sample record values of the values in a vector. The record values are the values in a vector when a record occurs.

If the argument X is a matrix, then each column is treated as a different vector.

Usage

R.record(X, record = c("upper", "lower"), weak = FALSE)

Arguments

X

A numeric vector, matrix (or data frame).

record

A character string indicating the type of record to be calculated, "upper" or "lower".

weak

Logical. If TRUE, weak records are also counted. Default to FALSE.

Value

If X is a vector, the function returns a column matrix containing the record values. If X is a matrix, the function returns a list where each element is a vector indicating the record values of the corresponding X column.

Details

The sequence of record values \(\{R_1,\ldots,R_I\}\) can be expressed in terms of the record times L.record by $$R_i = X_{L_i}.$$

Record values can be calculated for both upper and lower records.

References

Arnold BC, Balakrishnan N, Nagaraja HN (1998). Records. Wiley Series in Probability and Statistics. Wiley, New York.

See Also

I.record, L.record, N.record, Nmean.record, p.record, R.record, records, S.record

Examples

# NOT RUN {
Y1 <- c( 1,  5,  3,  6,  6,  9,  2)
Y2 <- c(10,  5,  3,  6,  6,  9,  2)
Y3 <- c( 5,  7,  3,  6, 19,  2, 20)
Y  <- cbind(Y1, Y2, Y3)

R.record(Y1)
R.record(Y)

# }