bacorliss / ACE

Analysis of Conservative Effects: research code repository for developing a new data analysis method for controlled experiments. Results can be classified as practically significant, practically insignificant, or inconclusive.
0 stars 0 forks source link
statistics

Analysis of Conservative Effects (ACE)

The official repository for (https://arxiv.org/abs/2201.01239) is found at a different repository: https://github.com/bac7wj/ACES

This repository is under continuous development for research.

This repository contains code necessary to compute the following statistics

  1. Most difference in means (δM): calculated with mdm_credint() in R/aces.R, with relative=FALSE
  2. Relative most difference in means (rδM): calculated with mdm_credint() in R/aces.R, with relative=TRUE
  3. Least difference in means (δL): calculated with ldm_credint() in R/aces.R, with relative=FALSE
  4. Relative Least difference in means (rδL): calculated with ldm_credint() in R/aces.R, with relative=TRUE

Note: run "set_wd_here.R" in base directoy first to set working directory to the base folder for the repository. All code assumes that is the location for the workign directory.

Folder Structure

  1. R/: general r code for calculating statistics, integrated risk analysis, and correlation tests

    1. aces.R: functions to calculate most difference in means and least difference in means statistics.

    2. __candidate_stats_from_xlsx.R__: functions to import data for applied examples.

    3. coverage_error_toolbox.R: simulation toolbox to test coverage error of mdm and rmdm (coverage error is the complement of coverage probability used for confidence intervals, code tests how often the mdm and rmdm is wrongly less than the pop. difference in means and rel. differnece in means).

    4. credibility_rate_toolbox.R: simulation toolbox to test credibility of mdm and rmdm.

    5. __illustrative_plot.R__: helper functions for producing plots to illustrate null strength and effect strength measures.

    6. __parallel_utils.R__: helper functions for parallel processing.

    7. row_stats_toolbox.R: helper functions for parallel processing.

    8. strength_risk_assessment.R: simulation toolbox to test candidate measures in identifying experiments with higher null strength or effect strength.

      Most difference in Means

  2. __mdm_t/__: scripts used to generate figures for δM and rδM manuscript (https://arxiv.org/abs/2201.01239)

    1. __figure2_covary_with_null_strength_SF2-5__: examines how candidate statistics respond to controlled changes of null strength. A valid statistics should respond in a consistent direction to increased null strength across all null strength measures.

    2. figure2_illustrations_null_strength_measures.R: A series of examples to illustrate the three parameters of unscaled agreement and relative agreement. Each example compares the difference in means or relative difference in means between a hypothetical control and experiment group.

    3. __figure3_risk_assessment_summary.R__: Runs a collection of risk assessments for test how often each candidate statistic incorrectly predicts which of two results have greater null strength.

    4. figure4-5_calculate_stats_from_sxls.R: creates excel table of results used as applied examples in manuscript.

    5. __sfigure1_mdm_credibility_rate.R__: calculates credibility rate of mdm with Monte Carlo method

    6. __sfigure1_rmdm_credibility_rate.R__: calculates credibility rate of rmdm with Monte Carlo method.

    7. sfigure6-7_unscaled_risk_assessment_null.r: Risk assessment for mu_dm, sigma_dm, df_dm, alpha_dm with null with identifying results with higher null strength.

    8. sfigure8-9_unscaled_risk_assessment_critical.r: Risk assessment for mu_dm, sigma_dm, df_dm, alpha_dm with identifying results with higher null strength.

    9. sfigure10-11_relative_risk_assessment_null.R: Risk assessment for rmu_dm, rsigma_dm, df_dm, alpha_dm with identifying results with higher null strength.

    10. sfigure12-13_risk_assessment_contest_crit.r: Risk assessment for rmu_dm, rsigma_dm, df_dm, alpha_dm with identifying results with higher null strength.

    Least difference in Means

  3. __ldm_t/__: scripts used to generate figures for δL and rδL manuscript (TBA)

    1. __figure2_covary_with_effect_strength_SF2-5__: examines how candidate statistics respond to controlled changes of effect strength. A valid statistics should respond in a consistent direction to increased effect strength across all effect strength measures.

    2. figure2_illustrations_effect_strength_measures.R: A series of examples to illustrate the three parameters of unscaled agreement and relative agreement. Each example compares the difference in means or relative difference in means between a hypothetical control and experiment group.

    3. __figure3_risk_assessment_summary.R__: Runs a collection of risk assessments for test how often each candidate statistic incorrectly predicts which of two results have greater effect strength.

    4. figure4-5_calculate_stats_from_sxls.R: creates excel table of results used as applied examples in manuscript.

    5. __sfigure1_mdm_credibility_rate.R__: calculates credibility rate of ldm with Monte Carlo method

    6. __sfigure1_rmdm_credibility_rate.R__: calculates credibility rate of rldm with Monte Carlo method.

    7. sfigure6-7_unscaled_risk_assessment_null.r: Risk assessment for mu_dm, sigma_dm, df_dm, alpha_dm with identifying results with higher effect strength.

    8. sfigure8-9_unscaled_risk_assessment_critical.r: Risk assessment for mu_dm, sigma_dm, df_dm, alpha_dm with identifying results with higher effect strength.

    9. sfigure10-11_relative_risk_assessment_null.R: Risk assessment for rmu_dm, rsigma_dm, df_dm, alpha_dm with identifying results with higher effect strength.

    10. sfigure12-13_risk_assessment_contest_crit.r: Risk assessment for rmu_dm, rsigma_dm, df_dm, alpha_dm with identifying results with higher effect strength.