cor.comb: Combine Correlations

Description Usage Arguments Details Value Note Author(s) See Also Examples

Description

This function was designed to meta-analytically combine the correlations of X and Y when the data come from non-independent samples.

Usage

1
2
cor.comb(y1, y2, y3, y4, x1, x2, x3, x4, sims = 1000, hist = FALSE, 
	rnd = 5, CI = TRUE, simple = FALSE, seed = 2)

Arguments

y1

vector paired with x1

y2

vector paired with x2

y3

vector paired with x3

y4

vector paired with x 4

x1

vector paired with y1

x2

vector paired with y2

x3

vector paired with y3

x4

vector paired with y4

sims

Number of simulations to be run in the randomization test (1000 by default).

hist

Logical: A histogram of the randomized results may be displayed by the 'hist' = 'TRUE' option.

rnd

An integer indicating the number of decimal places when results are displayed

CI

Logical: If the CI option is marked TRUE, 95 percent confidence intervals based on the randomization test results from the empirical sampling distribution will be output.

simple

Logical: When simple = F, the Weighted r is also provided for "Stouffer p" comparison. When simple = T, only the Unweighted r is returned.

seed

An integer indicating the starting value for a random seed. If no random seed is desired, set 'seed'=FALSE

Details

This function computes the average correlation for each of the 4 X-Y pairs and performs a randomization test to determine the probability of observing such a result under the null hypothesis of X and Y pairs are random.

Value

The output provides three slightly different types of p-values. The "normal p" provides the p-value that comes from dividing the difference between the observed meta-analytically combined correlation and the empirically simulated meta-analytically combined correlation by the standard deviation (i.e. standard error) of the empirical sampling distribution. This value is treated as a normal deviate Z and the p-value associated with that Z is computed. The "rand p" is given by the 2-tailed cumulative density of the empirically derived curve at the observed meta-analytically combined value. Finally, the "Stouffer p" is the p-value associated with a typical fixed effects approach to meta-analysis where the standard normal deviate Z-scores associated with each of the p-values for each of the four observed correlations are summed and divided by the squareroot of the number of correlations creating the sum. Before summing, the Z-values must be turned to face the same direction (i.e. if r > 0, Z > 0; if r < 0, Z < 0). While this method is typically associated with a weighted effect size estimate and this function computes an unweighted effect size estimate, the weighted and unweighted effect size estimates are equivalent to the degree to which the size of the samples are equivalent. When simple = F, the Weighted r is also provided for comparison. When simple = T, only the Unweighted r is returned.

Note

A note on the cor.comb function: The cor.comb function can easily be replaced by MLM procedures. While there is some nice interpretability features for the cor.comb function, MLM is generall more accepted in the literature. This function is probably most useful for comparisons with MLM results.

Author(s)

Ryne A. Sherman

See Also

cor.comb.rep

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
	data(RSPdata)
names(RSPdata)
	#Computing the relationship between self reported extraversion 
	#and Behavior measured by RBQ1 "Interviews others"over 4 situations 
data(rbqv3.items)
rbqv3.items # the RBQ content
	# The correlations between extraversion and RBQ001 in Situation 1
cor(RSPdata$sEXT,RSPdata$v2rbq001)  
cor(RSPdata$sEXT,RSPdata$v3rbq001) # ... Situation 2 
cor(RSPdata$sEXT,RSPdata$v4rbq001) # ... Situation 3
cor(RSPdata$sEXT,RSPdata$v5rbq001) # ... Situation 4 
	#now to use cor.comb to combine meta-analytically
cor.comb(y1=RSPdata$sEXT,y2=RSPdata$sEXT,y3=RSPdata$sEXT,
	y4=RSPdata$sEXT,x1=RSPdata$v2rbq001,x2=RSPdata$v3rbq001,
	x3=RSPdata$v4rbq001,x4=RSPdata$v5rbq001,hist=TRUE)

multicon documentation built on May 2, 2019, 3:18 a.m.