schemaMediation

Mediation association schema

Description

schemaMediation() defines the result and artifact contract for mediation analyses returned as PolyGeniusAssociations objects.

Usage

schemaMediation()

Value

A schema definition list.

Result semantics

Mediation rows represent estimands from a mediation analysis rather than ordinary regression coefficients.

  • outcome: endpoint being modeled in the outcome model.

  • exposure: exposure or predictor whose effect is decomposed.

  • mediator: mediator variable.

  • term: reported mediation estimand.

  • term.type: semantic estimand type, such as total, direct, indirect, or proportion.

  • effect: method-specific effect label.

  • effect.type: normalized effect type for plotting and filtering.

  • effect.scale: scale of estimate, usually identity or proportion.

  • estimate, se, lower, upper: estimand, standard error, and interval bounds.

  • statistic, p.value, adj.p.value: inferential statistic and p-values where available.

  • n: complete observations used by the mediation analysis.

  • formula.mediator, formula.outcome: displayed mediator and outcome model formulas when available.

Artifacts

Optional effect.decomposition contains plot-ready total/direct/indirect effect summaries. Optional path.summary contains mediator and outcome path summaries. Optional bootstrap.distribution contains aggregate bootstrap summaries when the method generates them.