psychmeta (version 1.0.2)

create_ad_int: Generate an artifact distribution object for use in interactive artifact-distribution meta-analysis programs.

Description

This function generates ad_obj class objects containing interactive artifact distributions. 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_int(rxxi = NULL, n_rxxi = NULL, wt_rxxi = n_rxxi,
  rxxi_type = rep("alpha", length(rxxi)), rxxa = NULL, n_rxxa = NULL,
  wt_rxxa = n_rxxa, rxxa_type = rep("alpha", length(rxxa)), ux = NULL,
  ni_ux = NULL, wt_ux = ni_ux, ut = NULL, ni_ut = NULL, wt_ut = ni_ut,
  estimate_rxxa = TRUE, estimate_rxxi = TRUE, estimate_ux = TRUE,
  estimate_ut = TRUE, ...)

Arguments

rxxi

Vector of incumbent reliability estimates.

n_rxxi

Vector of sample sizes associated with the elements of rxxi.

wt_rxxi

Vector of weights associated with the elements of rxxi.

rxxi_type, rxxa_type

String vector identifying the types of reliability estimates supplied (e.g., "alpha", "retest", "interrater_r", "splithalf"). See the documentation for ma_r for a full list of acceptable reliability types.

rxxa

Vector of applicant reliability estimates.

n_rxxa

Vector of sample sizes associated with the elements of rxxa.

wt_rxxa

Vector of weights associated with the elements of rxxa.

ux

Vector of observed-score u ratios.

ni_ux

Vector of incumbent sample sizes associated with the elements of ux.

wt_ux

Vector of weights associated with the elements of ux.

ut

Vector of true-score u ratios.

ni_ut

Vector of incumbent sample sizes associated with the elements of ut.

wt_ut

Vector of weights associated with the elements of ut.

estimate_rxxa

Logical argument to estimate rxxa values from other artifacts (TRUE) or to only used supplied rxxa values (FALSE). TRUE by default.

estimate_rxxi

Logical argument to estimate rxxi values from other artifacts (TRUE) or to only used supplied rxxi values (FALSE). TRUE by default.

estimate_ux

Logical argument to estimate ux values from other artifacts (TRUE) or to only used supplied ux values (FALSE). TRUE by default.

estimate_ut

Logical argument to estimate ut values from other artifacts (TRUE) or to only used supplied ut values (FALSE). TRUE by default.

...

Further arguments.

Value

Artifact distribution object (list of artifact-distribution tables) for use in interactive 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 artifact distributions will be given an artifact value of 1 and a weight of 1 as placeholders.

Examples

# NOT RUN {
create_ad_int(rxxa = c(.9, .8), n_rxxa = c(50, 150),
              rxxi = c(.8, .7), n_rxxi = c(50, 150),
              ux = c(.9, .8), ni_ux = c(50, 150),
              ut = c(.8, .7), ni_ut = c(50, 150))
# }