Learn R Programming

⚠️There's a newer version (2.7.0) of this package.Take me there.

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 tutorial vignette for an introduction to psychmeta's functions and workflows.

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")

The unofficial GitHub release of psychmeta reflects updates made to the package between official CRAN releases. Using the devtools package, the GitHub release can be installed with the following code:

install.packages("devtools")
devtools::install_github("jadahlke/psychmeta")

Citing `psychmeta`

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

citation("psychmeta")

Reporting Issues

To report bugs or other issues, email issues@psychmeta.com.

Copy Link

Version

Install

install.packages('psychmeta')

Monthly Downloads

628

Version

1.0.2

License

GPL (>= 3)

Maintainer

Jeffrey A. Dahlke

Last Published

May 1st, 2018

Functions in psychmeta (1.0.2)

print.psychmeta.ma_d.order2

print method for second-order meta-analyses of d values

Descriptive statistics for a mixture distribution

scalar_arg_warning

Warning message for scalar arguments receiving multiple values

Estimate mixture covariance matrix from within-group covariance matrices

print.psychmeta.ad_tsa

print method for Taylor series artifact distributions

print.psychmeta.ma_bootstrap

print method for bootstrapped meta-analyses

Screen to detect invalid Taylor series artifact distribution objects

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

Screen to detect impossible values in vectors of correlations and sample sizes.

ma_r_ad.tsa_uvirr

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

print.psychmeta.correct_r

print method for correlations corrected for artifacts

Estimate the error variance of reliability estimates

print.psychmeta.get_bootstrap

print method for lists of bootstrapped meta-analyses retrieved with get_bootstrap()

organize_moderators

Organization of moderator data for use in meta-analyses

Create forest plots

Estimate the mixture correlation for two groups

Clean warnings and remove warnings present in the environment before running the function of interest

composite_d_matrix

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

composite_r_scalar

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

composite_rel_matrix

Matrix formula to estimate the reliability of a weighted or unweighted composite variable

print.psychmeta

Master print method for objects of the 'psychmeta' class

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

Correct correlations for small-sample bias

Confidence interval method for objects of the class "lm_mat"

print.psychmeta.es

print method for effect sizes and converted effect sizes

print.psychmeta.ma_d.ic

print method for individual-correction meta-analyses of d values

Create a list of artifact distributions by construct

correct_r_coarseness

Correct correlations for scale coarseness

print.psychmeta.get_followup

print method for lists of follow-up analyses retrieved with get_followup()

correct_r_bvdrr

Correct correlations for bivariate direct range restriction and measurement error

correct_r_bvirr

Correct correlations for bivariate indirect range restriction and measurement error

composite_d_scalar

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

composite_r_matrix

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

print.psychmeta.simulate_psych

print method for simulated psychometric studies

Prediction method for objects of the class "lm_mat"

composite_u_scalar

Scalar formula to estimate the u ratio of a composite variable

Compute coefficient alpha

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

data_r_meas_multi

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

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

print.psychmeta.ma_generic

print method for bare-bones meta-analyses of correlations

confint.summary.lm_mat

Confidence interval method for objects of the class "summary.lm_mat"

print.psychmeta.get_metatab

print method for meta-analysis tables retrieved with get_metatab()

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

Estimation of statistics computed from products of random, normal variables

correct_means_mvrr

Multivariate select/correction for vectors of means

estimate_q_dist

Estimate descriptive statistics of square-root reliabilities

Second-order meta-analysis function for d values

print.psychmeta.ma_r.ad.master

print method for artifact-distribution meta-analyses of correlations

Individual-correction meta-analysis of d values

Filter to remove impossible values from vectors of reliabilities and corresponding weights.

Filter to remove impossible values from vectors of u ratios and corresponding weights.

ma_r_ad.int_uvdrr

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_rb1Adj

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

correct_r_split

Correct correlations for uneven/unrepresentative splits

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

Correct correlations for range restriction and/or measurement error

Add commas to integers Add commas to integers (e.g., convert "1000000" to "1,000,000")

correct_r_uvdrr

Correct correlations for Case II direct range restriction and measurement error

composite_rel_scalar

Scalar formula to estimate the reliability of a composite variable

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

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

composite_u_matrix

Matrix formula to estimate the u ratio of a composite variable

Write a summary table of meta-analytic results

data_r_roth_2015

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

create_ad_int_group

Generate an artifact distribution object for a dichotomous grouping variable for use in interactive artifact-distribution meta-analysis programs.

Hypothetical dataset simulated to satisfy the assumptions of the univariate 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

Compute meta-regressions

estimate_matrix_prods

Estimate covariance matrices and mean vectors containing product terms

convert_sdd_to_sdr

Convert the SD of d to the SD of r via TSA

convert_vard_to_varr

Convert the variance of d to the variance of r via TSA

convert_sdr_to_sdd

Convert the SD of r to the SD of d via TSA

Create long-format datasets in simulate_r_database

Create wide-format datasets in simulate_r_database

print.psychmeta.get_leave1out

print method for lists of leave-one-out meta-analyses retrieved with get_leave1out()

print.psychmeta.ma_r.ic

print method for individual-correction meta-analyses of correlations

convert_varr_to_vard

Convert the variance of r to the variance of d via TSA

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

Correct correlations for artificial dichotomization of one or both variables

print.psychmeta.ma_d.ic.master

print method for individual-correction meta-analyses of correlations

Supplemental heterogeneity statistics for meta-analyses

Correct correlations for measurement error

data_d_bb_multi

Hypothetical d value dataset simulated with sampling error only

Artifact-distribution meta-analysis of correlations

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

ma_r_ad.int_bvdrr

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

estimate_rel_dist

Estimate descriptive statistics of reliabilities

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

estimate_rel_sb

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

print.psychmeta.correct_d

print method for d values corrected for artifacts

ma_r_ad.tsa_uvdrr

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

print.psychmeta.get_heterogeneity

print method for lists of heterogeneity analyses retrieved with get_heterogeneity()

predict.summary.lm_mat

Prediction method for objects of the class "summary.lm_mat"

manage_arglength

Check the length of x against the length of y and replicate z if necessary

Filter meta-analyses

print.psychmeta.describe_simdat_r

print method for simulated psychometric studies

print.summary.lm_mat

Print method for objects of the class "summary.lm_mat"

print.psychmeta.ma_cumulative

print method for cumulative meta-analyses

Round numeric values to an exact number of digits and return as a character

Print method for objects of the class "lm_mat"

psychmeta-package

psychmeta: Psychometric meta-analysis toolkit

var_error_delta

Estimate the error variance of Glass' delta values

Estimate the error variance Cohen's d values

simulate_r_database

Simulate correlation databases of primary studies

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

print.psychmeta.ma_r.ic.master

print method for individual-correction meta-analyses of correlations

reshape_vec2mat

Assemble a variance-covariance matrix

Estimate the error variance Hedge's g values

Filter to detect and remove impossible values in vectors of correlations and sample sizes.

Confidence limits of tau

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

Master framework for meta-analysis of d values

Anova method for objects of the class "lm_mat"

reshape_wide2long

Reshape database from wide format to long format

print.psychmeta.ma_d.ad

print method for artifact-distribution meta-analyses of d values

print.psychmeta.simdat_d

print method for simulated psychometric studies

print.psychmeta.heterogeneity

print method for heterogeneity statistics

print.psychmeta.ma_r.order2

print method for second-order meta-analyses of correlations

Comprehensive \(d_{Mod}\) calculator

compute_dmod_npar

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

convert_pq_to_p

Convert the variance of a dichotomous variable (i.d., pq) to the proportion of one of the categories in the variable (i.e., p)

simulate_r_sample

Simulation of data with measurement error and range-restriction artifacts

Bare-bones meta-analysis of generic effect sizes

convert_reltype2consistency

Convert string variable containing reliability type indicators to a logical variable indicating whether a reliability value is an internal-consistency estimate or a multiple-administration estimate

correct_glass_bias

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

correct_matrix_mvrr

Multivariate select/correction for covariance matrices

correct_r_uvirr

Correct correlations for Case IV indirect range restriction and measurement error

Master framework for meta-analysis of correlations

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_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

Screen to detect invalid interactive artifact distribution objects

Bare-bones meta-analysis of correlations

Weighted descriptive statistics for a vector of numbers

Construct a credibility interval

create_ad_tsa_group

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

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

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

estimate_artifacts

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

Individual-correction meta-analysis of correlations

Estimate u ratios from available artifact information

print.psychmeta.get_cumulative

print method for lists of cumulative meta-analyses retrieved with get_cumulative()

Estimate the error variance of square roots of reliability estimates

estimate_var_artifacts

Taylor series approximations for the variances of estimates artifact distributions.

Generate a list of references included in meta-analyses

generate_directory

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

sparsify_simdat_d

Create sparse artifact information in a "simdat_d" class object

impute_artifacts

Impute missing and impossible artifact values

interval_warning

Warning message for the widths of uncertainty intervals

ma_r_ad.int_bvirr

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

ma_r_ad.int_meas

Interactive artifact-distribution meta-analysis correcting for measurement error

ma_r_ad.int_uvirr

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

print.psychmeta.simulate_d

print method for simulated psychometric studies

print.psychmeta.ma_d.ad.master

print method for artifact-distribution meta-analyses of correlations

anova.summary.lm_mat

Anova method for objects of the class "summary.lm_mat"

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

print.psychmeta.get_matrix

print method for meta-analytic matrices retrieved with get_matrix()

print.psychmeta.get_metareg

print method for lists of meta-regression analyses retrieved with get_metareg()

print.psychmeta.ma_d.barebones

print method for bare-bones meta-analyses of d values

Retrieve the NEWS file for the psychmeta package

Check whether wt_type argument is valid and determine which package to use for weights

ma_r_ad.tsa_bvdrr

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

Second-order meta-analysis function for correlations

print.psychmeta.simdat_r

print method for simulated psychometric studies

compute_dmod_par

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

Convert effect sizes and compute confidence intervals

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

Construct a confidence interval

Summary of FYI messages generated within a function

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

Correct d values for range restriction and/or measurement error

Correct for small-sample bias in Cohen's d values

Create funnel plots

Screen to detect impossible values in vectors of u ratios.

print.psychmeta.ad_int

print method for interactive artifact distributions

create_ad_array

Create an array of all possible combinations of artifact values from 2-4 artifact distributions

Screen to detect impossible values in vectors of reliability estimates.

print.psychmeta.ma_d.barebones.master

print method for bare-bones meta-analyses of correlations

print.psychmeta.get_escalc

print method for lists of escalc objects retrieved with get_escalc()

Summary method for objects of the class "lm_mat"

create_ad_group

Generate an artifact distribution object for a dichotomous grouping variable.

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

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

data_r_gonzalezmule_2014

Meta-analysis of OCB correlations with other constructs

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

data_r_mcdaniel_1994

Artifact-distribution meta-analysis of the validity of interviews

print.psychmeta.ma_r.barebones

print method for bare-bones meta-analyses of correlations

print.psychmeta.simulate_r

print method for simulated psychometric studies

print.psychmeta.ma_r.barebones.master

print method for bare-bones meta-analyses of correlations

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

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

simulate_d_sample

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

Estimate the error variance of u ratios

Compute weighted covariances

Sensitivity analyses for meta-analyses

estimate_var_tsa

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

Truncation function for means

Artifact-distribution meta-analysis of d values

filter_listnonnull

Filter a list to remove NULL entries

Bare-bones meta-analysis of d values

simulate_matrix

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

Truncation function for variances

ma_r_ad.int_none

Null artifact distribution result: No corrections performed

ma_r_ad.int_rbAdj

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

warning_variance

Warning message for invalid variances

ma_r_ad.tsa_bvirr

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

ma_r_ad.tsa_meas

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

Merge multiple "simdat_r" class objects

Merge multiple "simdat_d" class objects

organize_database

Organize a database of multi-construct or moderated information

print.psychmeta.dmod

print method for dmod effect sizes

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

print.psychmeta.ma_leave1out

print method for leave-one-out meta-analyses

print.psychmeta.get_plots

print method for meta-analysis plots retrieved with get_plots()

print.psychmeta.ma_r.ad

print method for artifact-distribution meta-analyses of correlations

simulate_d_database

Simulate d value databases of primary studies

reshape_mat2dat

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

Summarize artifact information from meta-analyses into table format

record_warnings

Summary of warning messages generated within a function

Generate a vector of simulated sample alpha coefficients

sparsify_simdat_r

Create sparse artifact information in a "simdat_r" class object

var_error_r_bvirr

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

var_error_alpha

Analytic estimate of the sampling variance of alpha

Estimate the error variance of correlations