Package: POEMED 1.0.0

POEMED: Power Enhancement for High-Dimensional Mediation Analysis

Provides powerful global tests for high-dimensional mediation analysis with heterogeneous (and even contrasting) mediation effects, for continuous, binary, and count outcomes. The power enhancement (PE) idea augments a Wald test on the total indirect effect with a component that captures marginal signals from individual mediators, so that active mediators are detected even when their individual indirect effects cancel and the total indirect effect is zero. The package also identifies which individual mediators are active with familywise error rate or false discovery rate control. The methods implement Yu and Kelley (in press), "Power Enhancement in High-Dimensional Heterogeneous Mediation Analysis" (Journal of the American Statistical Association); the package also simulates mediation data under the homogeneous, heterogeneous, and contrasting patterns that the article studies, ships its empirical health-expenditure data as a benchmark and reruns that empirical analysis, and runs the designs of its Monte Carlo size and power studies. The name, 'POEMED', from POwer-Enhanced MEDiation, encodes the method. Every estimation and testing function returns a tidy 'data.frame' that prints with sensible rounding and composes with the broader R ecosystem.

Authors:Xiufan Yu [aut], Ken Kelley [aut, cre]

POEMED_1.0.0.tar.gz
POEMED_1.0.0.zip(r-4.7-any)POEMED_1.0.0.zip(r-4.6-any)POEMED_1.0.0.zip(r-4.5-any)
POEMED_1.0.0.tgz(r-4.6-any)POEMED_1.0.0.tgz(r-4.5-any)
POEMED_1.0.0.tar.gz(r-4.7-any)POEMED_1.0.0.tar.gz(r-4.6-any)
POEMED_1.0.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
POEMED/json (API)

# Install 'POEMED' in R:
install.packages('POEMED', repos = c('https://yelleknek.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/yelleknek/poemed/issues

Pkgdown/docs site:https://yelleknek.github.io

Datasets:

On CRAN:

Conda:

4.48 score 18 exports 13 dependencies

Last updated from:9e78f8a822. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK256
source / vignettesOK419
linux-releaseOK243
macos-releaseOK204
macos-oldrelOK185
windows-develOK222
windows-releaseOK221
windows-oldrelOK199
wasm-releaseOK102

Exports:glancemediation_ar1_covpe_identification_studype_mediatepe_mediationpe_mediation_linearpe_mediation_logisticpe_mediation_poissonpe_mediatorspe_power_curvepe_selectionpe_simulation_studysimulate_guo_mediationsimulate_mediation_datass_power_pe_mediationtidyWHO_mediation_analysisWHO_mediation_design

Dependencies:codetoolsforeachgenericsglmnetiteratorslatticeMatrixncvregRcppRcppEigenshapesurvivalwithr

Power Enhancement for High-Dimensional Mediation: A Guided Tour
1. What Is a Mediation Analysis? | 2. The Problem: Total-Indirect-Effect Tests Have a Blind Spot | 3. The Idea: A Power Enhancement Component | 4. A First Analysis, Step by Step | 5. Reading the Result Table | 6. Identifying Which Mediators Are Active | 7. Binary and Count Outcomes | 8. A Simulation Study: Size and Power | 9. The Real Application: Health Spending as a Mediator | Building One Analysis Design | The Full Subgroup Analysis | Why the Preprocessing Matters | 10. Beyond the Global Test: The Toolkit | A Formula Interface for Data Frames | Why Each Mediator? The Per-Mediator Table | Working With broom | All Three Multiplicity Methods at Once | Planning the Sample Size | 11. Bringing Your Own Data | When POEMED Is the Right Tool, and When It Is Not | References | Session Information

Last update: 2026-10-05
Started: 2026-10-02

Reproducing the Article's Analyses With POEMED
Empirical Data Analysis (Article Section 5) | Section 5, Table 1: Infant Mortality (IMR) | The Other Outcomes, and the Region-by-Income Cells | Six Cells Reported as NA | Why a Mediator? Opening Up the Screening Step | Reproducibility Notes | References | Session Information

Last update: 2026-10-05
Started: 2026-10-02

POEMED and the Competition: A Head-to-Head
Two Patterns of Mediation, Two Tests | Size Under the Global Null | Power Where It Counts: Heterogeneous Mediation | Homogeneous Mediation: Both Tests Work, and the Enhancement Still Helps | The Pattern Holds for Binary and Count Outcomes | Beyond a Yes/No: Which Mediators? | On Real Data | A Balanced Scorecard | Other Comparators | References | Session Information

Last update: 2026-10-03
Started: 2026-10-02

Readme and manuals

Help Manual

Help pageTopics
Example High-Dimensional Mediation Data Setsexample_binary example_continuous example_count example_data
Calibration Constants for the Real-Data-Motivated Heterogeneous Settingguo_calibration
Autoregressive (AR(1)) Covariance Matrix for Mediator Simulationmediation_ar1_cov
Monte Carlo Study of Individual-Mediator Identification (FWER / FDR)pe_identification_study
Power-Enhanced Mediation Test From a Data Frame (Formula Interface)pe_mediate
Power-Enhanced Test for High-Dimensional Mediationpe_mediation
Power-Enhanced Mediation Test for a Continuous Outcomepe_mediation_linear
Power-Enhanced Mediation Test for a Binary Outcomepe_mediation_logistic
Power-Enhanced Mediation Test for a Count Outcomepe_mediation_poisson
Per-Mediator Detail Behind a Power-Enhanced Mediation Testpe_mediators
Monte Carlo Size and Power Curve for the PE Mediation Testspe_power_curve
Active Mediators Identified Under Each Multiplicity Methodpe_selection
Run the Power Study Under Several Mediation Patterns at Oncepe_simulation_study
Plot a POEMED Resultplot.poemed_tbl
Broom Verbs for POEMED Resultsglance glance.poemed_tbl poemed_broom tidy tidy.poemed_tbl
Tidy Printing for POEMED Result Tablesformat.poemed_tbl poemed_tbl print.poemed_tbl rbind.poemed_tbl [.poemed_tbl
Simulate the Real-Data-Motivated Heterogeneous Mediation Settingsimulate_guo_mediation
Simulate High-Dimensional Mediation Datasimulate_mediation_data
Simulation-Based Sample Size Planning for the Power-Enhanced Mediation Testss_power_pe_mediation
Summarize a POEMED Tableprint.summary.poemed_tbl summary.poemed_tbl
WHO / World Bank Health-Expenditure Mediation Data (Benchmark Data Set)WHO_health_mediation
Codebook for the WHO Health-Expenditure IndicatorsWHO_indicator_codebook
Run the Article's Empirical Mediation AnalysisWHO_mediation_analysis
Build a Mediation Design From the WHO Health-Expenditure DataWHO_mediation_design