This function computes individual-correction meta-analyses of d values.
ma_d_ic(d, n1, n2 = NULL, n_adj = NULL, sample_id = NULL,
citekey = NULL, treat_as_d = TRUE, wt_type = "inv_var_mean",
error_type = "mean", correct_bias = TRUE, correct_rGg = FALSE,
correct_ryy = TRUE, correct_rr_g = FALSE, correct_rr_y = TRUE,
indirect_rr_g = TRUE, indirect_rr_y = TRUE, rGg = NULL, pi = NULL,
pa = NULL, ryy = NULL, ryy_restricted = TRUE, ryy_type = "alpha",
uy = NULL, uy_observed = TRUE, sign_rgz = 1, sign_ryz = 1,
conf_level = 0.95, cred_level = 0.8, conf_method = "t",
cred_method = "t", var_unbiased = TRUE, moderators = NULL,
cat_moderators = TRUE, moderator_type = "simple",
impute_method = "bootstrap_mod", decimals = 2, hs_override = FALSE,
use_all_arts = FALSE, estimate_pa = FALSE, supplemental_ads_y = NULL,
data = NULL, ...)Vector or column name of observed d values.
Vector or column name of sample sizes.
Vector or column name of sample sizes.
Optional: Vector or column name of sample sizes adjusted for sporadic artifact corrections.
Optional vector of identification labels for samples/studies in the meta-analysis.
Optional vector of bibliographic citation keys for samples/studies in the meta-analysis (if multiple citekeys pertain to a given effect size, combine them into a single string entry with comma delimiters (e.g., "citkey1,citekey2").
Logical scalar determining whether d values are to be meta-analyzed as d values (TRUE) or whether they should be meta-analyzed as correlations (FALSE).
Type of weight to use in the meta-analysis: options are "sample_size", "inv_var_mean" (inverse variance computed using mean effect size), and "inv_var_sample" (inverse variance computed using sample-specific effect sizes). Supported options borrowed from metafor are "DL", "HE", "HS", "SJ", "ML", "REML", "EB", and "PM" (see metafor documentation for details about the metafor methods).
Method to be used to estimate error variances: "mean" uses the mean effect size to estimate error variances and "sample" uses the sample-specific effect sizes.
Logical scalar that determines whether to correct correlations for small-sample bias (TRUE) or not (FALSE).
Logical scalar or vector that determines whether to correct the grouping variable variable for measurement error (TRUE) or not (FALSE).
Logical scalar or vector that determines whether to correct the Y variable for measurement error (TRUE) or not (FALSE).
Logical scalar or vector or column name determining whether each d value should be corrected for range restriction in the grouping variable (TRUE) or not (FALSE).
Logical scalar or vector or column name determining whether each d should be corrected for range restriction in Y (TRUE) or not (FALSE).
Logical vector or column name determining whether each d should be corrected for indirect range restriction in the grouping variable (TRUE) or not (FALSE).
Superseded in evaluation by correct_rr_x (i.e., if correct_rr_g == FALSE, the value supplied for indirect_rr_g is disregarded).
Logical vector or column name determining whether each d should be corrected for indirect range restriction in Y (TRUE) or not (FALSE).
Superseded in evaluation by correct_rr_y (i.e., if correct_rr_y == FALSE, the value supplied for indirect_rr_y is disregarded).
Vector or column name of reliability estimates for X.
Scalar or vector containing the restricted-group proportions of group membership. If a vector, it must either have as many elements as there are d values.
Scalar or vector containing the unrestricted-group proportions of group membership. If a vector, it must either have as many elements as there are d values.
Vector or column name of reliability estimates for Y.
Logical vector or column name determining whether each element of ryy is an incumbent reliability (TRUE) or an applicant reliability (FALSE).
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.
Vector or column name of u ratios for Y.
Logical vector or column name determining whether each element of uy is an observed-score u ratio (TRUE) or a true-score u ratio (FALSE).
Sign of the relationship between X and the selection mechanism (for use with bvirr corrections only).
Sign of the relationship between Y and the selection mechanism (for use with bvirr corrections only).
Confidence level to define the width of the confidence interval (default = .95).
Credibility level to define the width of the credibility interval (default = .80).
Distribution to be used to compute the width of confidence intervals. Available options are "t" for t distribution or "norm" for normal distribution.
Distribution to be used to compute the width of credibility intervals. Available options are "t" for t distribution or "norm" for normal distribution.
Logical scalar determining whether variances should be unbiased (TRUE) or maximum-likelihood (FALSE).
Matrix or column names of moderator variables to be used in the meta-analysis (can be a vector in the case of one moderator).
Logical scalar or vector identifying whether variables in the moderators argument are categorical variables (TRUE) or continuous variables (FALSE).
Type of moderator analysis: "none" means that no moderators are to be used, "simple" means that moderators are to be examined one at a time, "hierarchical" means that all possible combinations and subsets of moderators are to be examined, and "all" means that simple and hierarchical moderator analyses are to be performed.
Method to use for imputing artifacts. See the documentation for ma_r for a list of available imputation methods.
Number of decimal places to which results should be rounded (default is to perform no rounding).
When TRUE, this will override settings for wt_type (will set to "sample_size"), error_type (will set to "mean"),
correct_bias (will set to TRUE), conf_method (will set to "norm"), cred_method (will set to "norm"), and var_unbiased (will set to FALSE).
Logical scalar that determines whether artifact values from studies without valid effect sizes should be used in artifact distributions (TRUE) or not (FALSE).
Logical scalar that determines whether the unrestricted subgroup proportions associated with univariate-range-restricted effect sizes should be estimated by rescaling the range-restricted subgroup proportions as a function of the range-restriction correction (TRUE) or not (FALSE; default).
List supplemental artifact distribution information from studies not included in the meta-analysis. The elements of this list are named like the arguments of the create_ad() function.
Data frame containing columns whose names may be provided as arguments to vector arguments and/or moderators.
Further arguments to be passed to functions called within the meta-analysis.
A list object of the classes psychmeta, ma_d_as_r or ma_d_as_d, ma_bb, and ma_ic.
Schmidt, F. L., & Hunter, J. E. (2015). Methods of meta-analysis: Correcting error and bias in research findings (3rd ed.). Thousand Oaks, California: SAGE Publications, Inc. Chapter 3.
Dahlke, J. A., & Wiernik, B. M. (2018). One of these artifacts is not like the others: Accounting for indirect range restriction in organizational and psychological research. Manuscript submitted for review.
# NOT RUN {
## Example meta-analyses using simulated data:
ma_d_ic(d = d, n1 = n1, n2 = n2, ryy = ryyi, correct_rr_y = FALSE,
data = data_d_meas_multi[data_d_meas_multi$construct == "Y",])
ma_d_ic(d = d, n1 = n1, n2 = n2, ryy = ryyi, correct_rr_y = FALSE,
data = data_d_meas_multi[data_d_meas_multi$construct == "Z",])
# }
Run the code above in your browser using DataLab