Learn R Programming

psychmeta (version 0.2.4)

var_error_r_bvirr: Taylor series approximation of the sampling variance of correlations corrected using the Case V correction for indirect range restriction

Description

This function propagates error in the bivariate indirect range-restriction correction forumula to allow for the computation of a pseudo compound attenutation factor in individual-correction meta-analysis. Traditional methods for estimating compound attenuation factors (i.e., dividing the observed correlation by the corrected correlation) do not work with the BVIRR correction because BVIRR has an additive term that makes the corrected correlation inappropriate for use in estimating the effect of the correction on the variance of the sampling distribution of correlations. The equation-implied adjustment for the BVIRR correction (i.e., the first derivative of the correction equation with respect to the observed correlation) underestimates the error of corrected correlations, so this function helps to account for that additional error.

Usage

var_error_r_bvirr(rxyi, var_e = NULL, ni, na = NA, ux, uy, qx,
  qx_restricted = TRUE, qy, qy_restricted = TRUE, mean_rxyi = NULL,
  mean_ux = NULL, mean_uy = NULL, mean_qxa = NULL, mean_qya = NULL,
  var_rxyi = NULL, var_ux = NULL, var_uy = NULL, var_qxa = NULL,
  var_qya = NULL, cor_rxyi_ux = 0, cor_rxyi_uy = 0, cor_rxyi_qxa = 0,
  cor_rxyi_qya = 0, cor_ux_uy = 0, cor_ux_qxa = 0, cor_ux_qya = 0,
  cor_uy_qxa = 0, cor_uy_qya = 0, cor_qxa_qya = 0, sign_rxz = 1,
  sign_ryz = 1, r_deriv_only = FALSE)

Arguments

rxyi

Vector of observed correlations.

var_e

Vector of estimated sampling variances for rxyi values.

ni

Vector of incumbent sample sizes (necessary when variances of correlations/artifacts are not supplied).

na

Optional vector of applicant sample sizes (for estimating error variance of u ratios and applicant reliabilities).

ux

Vector of observed-score u ratios for X.

uy

Vector of observed-score u ratios for Y.

qx

Vector of square roots of reliability estimates for X.

qx_restricted

Logical vector determining whether each element of qx is derived from an incumbent reliability (TRUE) or an applicant reliability (FALSE).

qy

Vector of square roots of reliability estimates for X.

qy_restricted

Logical vector determining whether each element of qy is derived from an incumbent reliability (TRUE) or an applicant reliability (FALSE).

mean_rxyi

Mean observed correlation.

mean_ux

Mean observed-score u ratio for X (for use in estimating sampling errors in the context of a meta-analysis).

mean_uy

Mean observed-score u ratio for Y (for use in estimating sampling errors in the context of a meta-analysis).

mean_qxa

Mean square-root applicant reliability estimate for X (for use in estimating sampling errors in the context of a meta-analysis).

mean_qya

Mean square-root applicant reliability estimate for Y (for use in estimating sampling errors in the context of a meta-analysis).

var_rxyi

Optional pre-specified variance of correlations.

var_ux

Optional pre-specified variance of observed-score u ratios for X.

var_uy

Optional pre-specified variance of observed-score u ratios for Y.

var_qxa

Optional pre-specified variance of square-root applicant reliability estimate for X.

var_qya

Optional pre-specified variance of square-root applicant reliability estimate for Y.

cor_rxyi_ux

Correlation between rxyi and ux (zero by default).

cor_rxyi_uy

Correlation between rxyi and uy (zero by default).

cor_rxyi_qxa

Correlation between rxyi and qxa (zero by default).

cor_rxyi_qya

Correlation between rxyi and qya (zero by default).

cor_ux_uy

Correlation between ux and uy (zero by default).

cor_ux_qxa

Correlation between ux and qxa (zero by default).

cor_ux_qya

Correlation between ux and qya (zero by default).

cor_uy_qxa

Correlation between uy and qxa (zero by default).

cor_uy_qya

Correlation between uy and qya (zero by default).

cor_qxa_qya

Correlation between qxa and qya (zero by default).

sign_rxz

Sign of the relationship between X and the selection mechanism.

sign_ryz

Sign of the relationship between Y and the selection mechanism.

r_deriv_only

Logical scalar determining whether to use the partial derivative with respect to rxyi only (TRUE) or a full Taylor series approximation of the disattenuation formula (FALSE).

Value

A vector of corrected correlations' sampling-error variances.

Details

Per the principles of propagation of uncertainty and assuming that \(q_{X_{a}}\), \(q_{Y_{a}}\), \(u_{X}\), \(u_{Y}\), and \(\rho_{XY_{i}}\), are independent, we can derive a linear approximation of the sampling error of \(\rho_{TP_{a}}\). We begin with the bivariate indirect range restriction formula,

$$\rho_{TP_{a}}=\frac{\rho_{XY_{i}}u_{X}u_{Y}+\lambda\sqrt{\left|1-u_{X}^{2}\right|\left|1-u_{Y}^{2}\right|}}{q_{X_{a}}q_{Y_{a}}}$$

which implies the following linear approximation of the sampling variance of \(\rho_{TP_{a}}\):

$$SE_{\rho_{TP_{a}}}^{2}=b_{1}^{2}SE_{q_{X_{a}}}^{2}+b_{2}^{2}SE_{q_{Y_{a}}}^{2}+b_{3}^{2}SE_{u_{X}}^{2}+b_{4}^{2}SE_{u_{Y}}^{2}+b_{5}^{2}SE_{\rho_{XY_{i}}}^{2}$$

where \(b_{1}\), \(b_{2}\), \(b_{3}\), \(b_{4}\), and \(b_{5}\) are the first-order partial derivatives of the disattenuation formula with respect to \(q_{X_{a}}\), \(q_{Y_{a}}\), \(u_{X}\), \(u_{Y}\), and \(\rho_{XY_{i}}\), respectively. These partial derivatives are computed as follows:

$$b_{1}=\frac{\partial\rho_{TP_{a}}}{\partial q_{X_{a}}}=-\frac{\rho_{TP_{a}}}{q_{X_{a}}}$$ $$b_{2}=\frac{\partial\rho_{TP_{a}}}{\partial q_{Y_{a}}}=-\frac{\rho_{TP_{a}}}{q_{Y_{a}}}$$ $$b_{3}=\frac{\partial\rho_{TP_{a}}}{\partial u_{X}}=\left[\rho_{XY_{i}}u_{Y}-\frac{\lambda u_{X}\left(1-u_{X}^{2}\right)\sqrt{\left|1-u_{Y}^{2}\right|}}{\left|1-u_{X}^{2}\right|^{1.5}}\right]/\left(q_{X_{a}}q_{Y_{a}}\right)$$ $$b_{4}=\frac{\partial\rho_{TP_{a}}}{\partial u_{Y}}=\left[\rho_{XY_{i}}u_{X}-\frac{\lambda u_{Y}\left(1-u_{Y}^{2}\right)\sqrt{\left|1-u_{X}^{2}\right|}}{\left|1-u_{Y}^{2}\right|^{1.5}}\right]/\left(q_{X_{a}}q_{Y_{a}}\right)$$ $$b_{5}=\frac{\partial\rho_{TP_{a}}}{\partial\rho_{XY_{i}}}=\frac{u_{X}u_{Y}}{q_{X_{a}}q_{Y_{a}}}$$

References

Dahlke, J. A., & Wiernik, B. M. (2017). One of these artifacts is not like the others: New methods to account for the unique implications of indirect range-restriction corrections in organizational research. Unpublished manuscript.

Examples

Run this code
# NOT RUN {
var_error_r_bvirr(rxyi = .3, var_e = var_error_r(r = .3, n = 100), ni = 100,
                ux = .8, uy = .8,
                qx = .9, qx_restricted = TRUE,
                qy = .9, qy_restricted = TRUE,
                sign_rxz = 1, sign_ryz = 1)
# }

Run the code above in your browser using DataLab