R: Unit of Measure Conversion for Circular Data and other...

conversion.circular {circular} | R Documentation

## Unit of Measure Conversion for Circular Data and other conversions

### Description

Conversion for Circular Data from one coordinate/units system to another one. For back compatibility, without arguments the function converts data from degrees to radians.

### Usage

    conversion.circular(x, units = c("radians", "degrees", "hours"), type = NULL,
      template = NULL, modulo = NULL, zero = NULL, rotation = NULL)

### Arguments

`x` | an object of class `circular`.
`units` | unit of the transformed data.
`type` | type of the transformed data. If `NULL` no action is performed.
`template` | template of the tranformed data. If `NULL` no action is performed.
`modulo` | modulo of the transformed data. If `NULL` no action is performed.
`zero` | zero of the tranformed data. If `NULL` no action is performed.
`rotation` | rotation of the tranformed data. If `NULL` no action is performed.

### Value

an object of class `circular` with the specified unit of measure, modulo, zero and rotation.

### Author(s)

Claudio Agostinelli

### See Also

`deg` and `rad`. If you want to set the properties of an object instead to tranform it, you can use `circular` or `circularp<-`.

### Examples

    x <- rvonmises(n=10, mu=circular(0), kappa=9, control.circular=list(units="degrees"))
    par(mfcol=c(2, 2))
    plot(x)
    y <- conversion.circular(x) # only the unit is changed (to radians) and
    ####### the data converted.
    plot(y)
    z <- conversion.circular(x, units="degrees", zero=pi) # only the zero is changed and
    ####### the data converted.
    plot(z)
    w <- conversion.circular(x, zero=pi, rotation="clock") # zero and rotation is
    ####### changed and the data converted.
    plot(w)

[Package circular version 0.4-93 Index]