R: Circular Range

range.circular {circular} | R Documentation

## Circular Range

### Description

Computes the circular range of a data set and performs a test of uniformity if specified.

### Usage

    ## S3 method for class 'circular'
    range(x, test=FALSE, na.rm = FALSE, finite = FALSE,
      control.circular=list(), ...)

### Arguments

`x` | a vector. The object is coerced to class `circular`.
`test` | logical flag: if TRUE then the test of uniformity is performed; otherwise the test is not performed. Default is FALSE.
`na.rm` | logical, indicating if `NA`'s should be omitted.
`finite` | logical, indicating if all non-finite elements should be omitted.
`control.circular` | the attribute of the resulting object.
`...` | further parameter passed from/to the method.

### Details

The circular range is the shortest arc on the circle containing the entire set of data. The p-value is computed using the exact distribution of the circular range under the hypothesis of uniformity, details can be found in Mardia and Jupp (1999) pag. 107.

### Value

Returns the circular range as a `circular` object. If the significance test is requested the p-value of the test is returned as p.value.

### Author(s)

Claudio Agostinelli and Ulric Lund

### References

K.V. Mardia and P.E. Jupp (1999) Directional Statistics, Wiley.

### See Also

`kuiper.test`, `rao.spacing.test`, `rayleigh.test` and `watson.test`.

### Examples

    data <- rvonmises(n=50, mu=circular(0), kappa=2)
    range(data, test=TRUE)
    data <- circular(runif(50, 0, 2*pi))
    range(data, test=TRUE)

[Package circular version 0.4-93 Index]