circ_lin_corr: Circular-linear correlation

In circhelp: Circular Analyses Helper Functions

Circular-linear correlation

Description

\loadmathjax

Implementation of the circular-linear correlation measure introduced by Mardia (1976) and Johnson and Wehrly (1977) as cited in Jammalamadaka & Sengupta (2001).

Usage

circ_lin_corr(circ_x, lin_x, na.rm = FALSE)

Arguments

circ_x	circular variable
lin_x	linear variable
na.rm	a logical value indicating whether NA values should be removed before the computation proceeds

Details

This measure is computed as \mjsdeqnr^2 = (r_xc^2+r_xs^2-2 r_xc r_xsr_cs)/(1-r_cs^2) where \mjseqnr_xc = corr(x, cos(\alpha)), \mjseqnr_xs = corr(x, sin(\alpha)), \mjseqnr_cs = corr(cos(\alpha), sin(\alpha)), and \mjseqn\alpha and \mjseqnx are the circular and linear variables, respectively.

Value

circular-linear correlation measure

References

Jammalamadaka, S. R., & SenGupta, A. (2001). Topics in Circular Statistics. WORLD SCIENTIFIC. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1142/4031")}

Examples

x <- rnorm(50)
a <- as.vector(circular::rvonmises(50, 0, 5))
circ_lin_corr(x + a, x)

circhelp documentation built on Sept. 11, 2024, 8:10 p.m.