psychmeta (version 0.2.4)

create_ad_tsa_group: Generate an artifact distribution object for a dichotomous grouping variable for use in Taylor series artifact-distribution meta-analysis programs.

Description

This wrapper for link{create_ad_tsa} generates ad_obj class objects containing Taylor series artifact distributions for dichotomous group-membership variables. Use this to create objects that can be supplied to the ma_r_ad and ma_d_ad functions to apply psychometric corrections to barebones meta-analysis objects via artifact distribution methods.

Usage

create_ad_tsa_group(rGg = NULL, n_rGg = NULL, wt_rGg = n_rGg,
  mean_rGg = NULL, var_rGg = NULL, k_rGg = NULL, mean_n_rGg = NULL,
  pi = NULL, pa = NULL, n_pi = NULL, n_pa = NULL, wt_p = n_pi,
  var_unbiased = TRUE, ...)

Arguments

rGg

Vector of incumbent reliability estimates.

n_rGg

Vector of sample sizes associated with the elements of rGg.

wt_rGg

Vector of weights associated with the elements of rGg (by default, sample sizes will be used as weights).

mean_rGg

Vector that can be used to supply the means of externally computed distributions of correlations between observed and latent group membership.

var_rGg

Vector that can be used to supply the variances of externally computed distributions of correlations between observed and latent group membership.

k_rGg

Vector that can be used to supply the number of studies included in externally computed distributions of correlations between observed and latent group membership.

mean_n_rGg

Vector that can be used to supply the mean sample sizes of externally computed distributions of correlations between observed and latent group membership.

pi

Vector of incumbent/sample proportions of members in one of the two groups being compared (one or both of pi/pa can be vectors - if both are vectors, they must be of equal length).

pa

Vector of applicant/population proportions of members in one of the two groups being compared (one or both of pi/pa can be vectors - if both are vectors, they must be of equal length).

n_pi

Vector of sample sizes associated with the elements in pi.

n_pa

Vector of sample sizes associated with the elements in pa.

wt_p

Vector of weights associated with the collective element pairs in pi and pa.

var_unbiased

Logical scalar determining whether variance should be unbiased (TRUE) or maximum-likelihood (FALSE).

...

Further arguments.

Value

Artifact distribution object (matrix of artifact-distribution means and variances) for use in Taylor serices artifact-distribution meta-analyses.

Details

Allows consolidation of observed and estimated artifact information by cross-correcting artifact distributions and forming weighted artifact summaries.

All artifact distributions are optional; null distributions will be given a mean of 1 and variance of 0 if not information is supplied.

Examples

# NOT RUN {
## Example artifact distribution for a dichotomous grouping variable:
create_ad_tsa_group(rGg = c(.8, .9, .95), n_rGg = c(100, 200, 250),
                    mean_rGg = .9, var_rGg = .05,
                    k_rGg = 5, mean_n_rGg = 100,
                    pi = c(.6, .55, .3), pa = .5, n_pi = c(100, 200, 250), n_pa = 300,
                    var_unbiased = TRUE)
# }