R: Produces weighted correlations with standard errors and...

wtd.cor {weights} | R Documentation

## Produces weighted correlations with standard errors and significance. For a faster version without standard errors and p values, use the `wtd.cors` function.

### Description

`wtd.cor` produces a Pearsons correlation coefficient comparing two variables or matrices. Note that weights run with the default parameters here treat the weights as an estimate of the precision of the information. For survey data, users should run this code with bootstrapped standard errors `bootse=TRUE`, which are robust to heteroskadesticity, although these will vary slightly each time the weights are run. A prior version of this software was set to default to `mean1=FALSE` and `bootse=FALSE`.

### Usage

    wtd.cor(x, y=NULL, weight=NULL, mean1=TRUE, collapse=TRUE, bootse=FALSE,
    bootp=FALSE, bootn=1000)

### Arguments

`x` | `x` should be a matrix or vector which the researcher wishes to correlate with `y`.
`y` | `y` should be a numerical vector or matrix which the researcher wishes to correlate with `x`. If `y` is NULL, `x` will be used instead
`weight` | `weight` is an optional vector of weights to be used to determining the weighted mean and variance for calculation of the correlations.
`mean1` | `mean1` is an optional parameter for determining whether the weights should be forced to have an average value of 1. If this is set as false, the weighted correlations will be produced with the assumption that the true N of the data is equivalent to the sum of the weights.
`collapse` | `collapse` is an indicator for whether the data should be collapsed to a simpler form if either x or y is a vector instead of a matrix.
`bootse` | `bootse` is an optional parameter that produces bootstrapped standard errors. This should be used to address heteroskadesticity issues when weights indicate probabilities of selection rather than the precision of estimates.
`bootp` | `bootp` is an optional parameter that produces bootstrapped p values instead of estimating p values from the standard errors. This parameter only operates when `bootse=TRUE`.
`bootn` | `bootn` is an optional parameter that is used to indicate the number of bootstraps that should be run for `bootse` and `bootp`.

### Value

A list with matrices for the estimated correlation coefficient, the standard error on that correlation coefficient, the t-value for that correlation coefficient, and the p value for the significance of the correlation. If the list can be simplified, simplification will be done.

### Author(s)

Josh Pasek, Assistant Professor of Communication Studies at the University of Michigan (www.joshpasek.com).

### See Also

`wtd.cors` `stdz` `wtd.t.test` `wtd.chi.sq`

### Examples

    test <- c(1,1,1,1,1,1,2,2,2,3,3,3,4,4)
    t2 <- rev(test)
    weight <- c(.5,.5,.5,.5,.5,1,1,1,1,2,2,2,2,2)

    wtd.cor(test, t2)
    wtd.cor(test, t2, weight)
    wtd.cor(test, t2, weight, bootse=TRUE)

[Package weights version 1.0.2 Index]