Learn R Programming

psychmeta

Psychometric Meta-Analysis Toolkit

Overview

The psychmeta package provides tools for computing bare-bones and psychometric meta-analyses and for generating psychometric data for use in meta-analysis simulations. Currently, the package supports bare-bones, individual-correction, and artifact-distribution methods for meta-analyzing correlations and d values. Please refer to the overview vignette vignette("overview", package = "psychmeta") for an introduction to psychmeta's functions and workflows (also found here).

Authors

psychmeta was written by Jeffrey A. Dahlke and Brenton M. Wiernik.

Installation

The official CRAN release of psychmeta can be installed with the following code:

install.packages("psychmeta")

Development versions of psychmeta from GitHub reflect updates made to the package between official CRAN releases. The GitHub release can be installed with the following code:

install.packages("remotes")
remotes::install_github("psychmeta/psychmeta")

Citing psychmeta

To cite psychmeta in your research, please refer to the package's citation information using the citation() function.

citation("psychmeta")

Reporting Issues

To report a bug or other issue, tell us about it on GitHub or email issues@psychmeta.com. For more general questions and inquiries about the package, email psychmeta@psychmeta.com.

Copy Link

Version

Install

install.packages('psychmeta')

Monthly Downloads

716

Version

2.7.0

License

GPL (>= 3)

Maintainer

Last Published

June 19th, 2024

Functions in psychmeta (2.7.0)

compute_dmod

Comprehensive \(d_{Mod}\) calculator
composite_r_scalar

Scalar formula to estimate the correlation between a composite and another variable or between two composite variables
compute_dmod_npar

Function for computing non-parametric \(d_{Mod}\) effect sizes for a single focal group
composite_rel_matrix

Matrix formula to estimate the reliability of a weighted or unweighted composite variable
conf.limits.nc.chisq

Confidence limits for noncentral chi square parameters (function and documentation from package 'MBESS' version 4.4.3) Function to determine the noncentral parameter that leads to the observed Chi.Square-value, so that a confidence interval for the population noncentral chi-square value can be formed.
compute_dmod_par

Function for computing parametric \(d_{Mod}\) effect sizes for any number of focal groups
confidence_r

Construct a confidence interval for correlations using Fisher's z transformation
compute_alpha

Compute coefficient alpha
anova.ma_psychmeta

Wald-type tests for moderators in psychmeta meta-analyses
composite_d_matrix

Matrix formula to estimate the standardized mean difference associated with a weighted or unweighted composite variable
confidence

Construct a confidence interval
composite_u_scalar

Scalar formula to estimate the u ratio of a composite variable
correct_d

Correct \(d\) values for measurement error and/or range restriction
convert_es

Convert effect sizes
correct_d_bias

Correct for small-sample bias in Cohen's \(d\) values
convert_ma

Function to convert meta-analysis of correlations to d values or vice-versa
correct_matrix_mvrr

Multivariate select/correction for covariance matrices
correct_glass_bias

Correct for small-sample bias in Glass' \(\Delta\) values
create_ad_tibble

Create a tibble of artifact distributions by construct
create_ad_group

Generate an artifact distribution object for a dichotomous grouping variable.
credibility

Construct a credibility interval
create_ad

Generate an artifact distribution object for use in artifact-distribution meta-analysis programs.
data_r_gonzalezmule_2014

Meta-analysis of OCB correlations with other constructs
correct_r_split

Correct correlations for uneven/unrepresentative splits
correct_means_mvrr

Multivariate select/correction for vectors of means
correct_r_dich

Correct correlations for artificial dichotomization of one or both variables
correct_r

Correct correlations for range restriction and/or measurement error
correct_r_bias

Correct correlations for small-sample bias
correct_r_coarseness

Correct correlations for scale coarseness
data_r_mcdaniel_1994

Artifact-distribution meta-analysis of the validity of interviews
data_r_roth_2015

Artifact-distribution meta-analysis of the correlation between school grades and cognitive ability
confint

Confidence interval method for objects of classes deriving from lm_mat
data_r_uvdrr

Hypothetical dataset simulated to satisfy the assumptions of the univariate correction for direct range restriction
control_intercor

Control function to curate intercorrelations to be used in automatic compositing routine
data_r_bvdrr

Hypothetical dataset simulated to satisfy the assumptions of the bivariate correction for direct range restriction
estimate_length_sb

Inverse Spearman-Brown formula to estimate the amount by which a measure would have to be lengthened or shorted to achieve a desired level of reliability
estimate_matrix_prods

Estimate covariance matrices and mean vectors containing product terms
estimate_q_dist

Estimate descriptive statistics of square-root reliabilities
data_r_oh_2009

Second order meta-analysis of operational validities of big five personality measures across East Asian countries
data_r_meas_multi

Hypothetical correlation dataset simulated to satisfy the assumptions of the correction for measurement error only in multiple constructs
estimate_prod

Estimation of statistics computed from products of random, normal variables
control_psychmeta

Control for psychmeta meta-analyses
estimate_u

Estimate u ratios from available artifact information
data_d_bb_multi

Hypothetical d value dataset simulated with sampling error only
convert_consistency2reltype

Convert logical variable indicating whether a reliability value is an internal-consistency estimate or a multiple-administration estimate to a string variable of generic reliability types
data_r_bvirr

Hypothetical dataset simulated to satisfy the assumptions of the bivariate correction for indirect range restriction
estimate_artifacts

Estimation of applicant and incumbent reliabilities and of true- and observed-score u ratios
estimate_rel_dist

Estimate descriptive statistics of reliabilities
data_r_uvirr

Hypothetical dataset simulated to satisfy the assumptions of the univariate correction for indirect range restriction
generate_bib

Generate a list of references included in meta-analyses
data_d_meas_multi

Hypothetical d value dataset simulated to satisfy the assumptions of the correction for measurement error only in multiple constructs
data_r_mcleod_2007

Bare-bones meta-analysis of parenting and childhood depression
format_num

Format numbers for presentation
estimate_var_artifacts

Taylor series approximations for the variances of estimates artifact distributions.
estimate_var_rho_int

Non-linear estimate of variance of \(\rho\) corrected for psychometric artifacts using numeric integration
estimate_var_rho_tsa

Taylor Series Approximation of variance of \(\rho\) corrected for psychometric artifacts
estimate_rel_sb

Spearman-Brown prophecy formula to estimate the reliability of a lengthened measure
format_wide

Create wide-format datasets in simulate_r_database
filter_ma

Filter meta-analyses
estimate_var_tsa

Taylor Series Approximation of effect-size variances corrected for psychometric artifacts
generate_directory

Generate a system of folders from a file path to a new directory
format_long

Create long-format datasets in simulate_r_database
filter_listnonnull

Filter a list to remove NULL entries
data_r_meas

Hypothetical dataset simulated to satisfy the assumptions of the correction for measurement error only
limits_tau2

Confidence limits of tau-squared
impute_artifacts

Impute missing and impossible artifact values
get_stuff

Extract results from a psychmeta meta-analysis object
heterogeneity

Supplemental heterogeneity statistics for meta-analyses
ma_d_order2

Second-order meta-analysis function for d values
ma_d

Meta-analysis of d values
limits_tau

Confidence limits of tau
lm_mat

Compute linear regression models and generate "lm" objects from covariance matrices.
ma_r_ad.int_meas

Interactive artifact-distribution meta-analysis correcting for measurement error
ma_r_ad.tsa_bvdrr

Taylor series approximation artifact-distribution meta-analysis correcting for Case V indirect range restriction and measurement error
ma_r_ad.int_uvdrr

Interactive artifact-distribution meta-analysis correcting for Case II direct range restriction and measurement error
ma_r_ad.int_uvirr

Interactive artifact-distribution meta-analysis correcting for Case IV indirect range restriction and measurement error
ma_generic

Bare-bones meta-analysis of generic effect sizes
ma_r_ad.tsa_rb2Orig

Taylor series approximation artifact-distribution meta-analysis correcting for Raju and Burke's case 2 direct range restriction and measurement error
ma_wrapper

Wrapper function to compute meta-analytic results for all analyses.
ma_r_order2

Second-order meta-analysis function for correlations
ma_r_ad.tsa_rb1Orig

Taylor series approximation artifact-distribution meta-analysis correcting for Raju and Burke's case 1 direct range restriction and measurement error
ma_r_ad.int_rbAdj

Interactive artifact-distribution meta-analysis correcting for Case II direct range restriction and measurement error
ma_r_ad.int_rbOrig

Interactive artifact-distribution meta-analysis correcting for Case II direct range restriction and measurement error
ma_r_ad.tsa_uvirr

Taylor series approximation artifact-distribution meta-analysis correcting for Case II direct range restriction and measurement error
ma_r_ad.tsa_bvirr

Taylor series approximation artifact-distribution meta-analysis correcting for Case V indirect range restriction and measurement error
merge_simdat_d

Merge multiple "simdat_d_database" class objects
ma_r_ad.tsa_rb2Adj

Taylor series approximation artifact-distribution meta-analysis correcting for Raju and Burke's case 2 direct range restriction and measurement error
ma_r

Meta-analysis of correlations
mix_dist

Descriptive statistics for a mixture distribution
ma_r_ad.int_bvdrr

Interactive artifact-distribution meta-analysis correcting for Case V indirect range restriction and measurement error
ma_r_ad.int_none

Null artifact distribution result: No corrections performed
mix_r_2group

Estimate the mixture correlation for two groups
ma_r_ad.tsa_uvdrr

Taylor series approximation artifact-distribution meta-analysis correcting for Case II direct range restriction and measurement error
organize_database

Organize a database of multi-construct or moderated information
metabulate_rmd_helper

Add metabulate equation commands and LaTeX dependencies
metareg

Compute meta-regressions
ma_r_ad.tsa_meas

Taylor series approximation artifact-distribution meta-analysis correcting for measurement error
ma_r_ad.int_bvirr

Interactive artifact-distribution meta-analysis correcting for Case V indirect range restriction and measurement error
merge_simdat_r

Merge multiple "simdat_r_database" class objects
mix_matrix

Estimate mixture covariance matrix from within-group covariance matrices
organize_moderators

Organization of moderator data for use in meta-analyses
ma_r_ad.tsa_rb1Adj

Taylor series approximation artifact-distribution meta-analysis correcting for Raju and Burke's case 1 direct range restriction and measurement error
plot_forest

Create forest plots
plot_funnel

Create funnel plots
metabulate

Write a summary table of meta-analytic results
reattribute

Copy class and attributes from the original version of an object to a modified version.
reshape_mat2dat

Extract a long-format correlation database from a correlation matrix and its supporting vectors/matrices of variable information
print

Print methods for psychmeta
reshape_vec2mat

Assemble a variance-covariance matrix
sensitivity

Sensitivity analyses for meta-analyses
psychmeta-package

psychmeta: Psychometric meta-analysis toolkit
simulate_alpha

Generate a vector of simulated sample alpha coefficients
predict

Prediction method for objects of classes deriving from lm_mat
summarize_ads

Summarize artifact information from meta-analyses into table format
reshape_wide2long

Reshape database from wide format to long format
simulate_r_database

Simulate correlation databases of primary studies
sparsify_simdat_r

Create sparse artifact information in a "simdat_r_database" class object
sparsify_simdat_d

Create sparse artifact information in a "simdat_d_database" class object
simulate_r_sample

Simulation of data with measurement error and range-restriction artifacts
summary

Summary methods for psychmeta
var_error_delta

Estimate the error variance of Glass's \(\Delta\) values
simulate_matrix

Generate a list of simulated sample matrices sampled from the Wishart distribution
var_error_alpha

Analytic estimate of the sampling variance of coefficient \(\alpha\)
simulate_psych

Simulate Monte Carlo psychometric data (observed, true, and error scores)
simulate_d_sample

Simulate a sample of psychometric d value data with measurement error, direct range restriction, and/or indirect range restriction
simulate_d_database

Simulate d value databases of primary studies
truncate_dist

Truncation function for normal distributions (truncates both mean and variance)
var_error_g

Estimate the error variance Hedges's \(g\) values
var_error_d

Estimate the error variance Cohen's \(d\) values
unmix_r_2group

Estimate the average within-group correlation from a mixture correlation for two groups
var_error_A

Estimate the error variance of the probability-based effect size (\(A\), AUC, the common language effect size [CLES])
var_error_r

Estimate the error variance of correlations
var_error_mult_R

Estimate the error variance of linear regression multiple R(-squared)
var_error_u

Estimate the error variance of \(u\) ratios
var_error_q

Estimate the error variance of square roots of reliability estimates
truncate_var

Truncation function for variances
var_error_r_bvirr

Taylor series approximation of the sampling variance of correlations corrected using the bivariate indirect range restriction correction (Case V)
unmix_matrix

Estimate average within-group covariance matrices from a mixture covariance matrix
var_error_rel

Estimate the error variance of reliability estimates
wt_dist

Weighted descriptive statistics for a vector of numbers
var_error_spearman

Estimate the error variance of Spearman rank correlations
wt_cov

Compute weighted covariances
truncate_mean

Truncation function for means
adjust_n_r

Adjusted sample size for a non-Pearson correlation coefficient for use in a meta-analysis of Pearson correlations
adjust_n_d

Adjusted sample size for a non-Cohen d value for use in a meta-analysis of Cohen's d values
composite_d_scalar

Scalar formula to estimate the standardized mean difference associated with a composite variable
composite_rel_scalar

Scalar formula to estimate the reliability of a composite variable
composite_u_matrix

Matrix formula to estimate the u ratio of a composite variable
composite_r_matrix

Matrix formula to estimate the correlation between two weighted or unweighted composite variables