schemaCox

Cox-regression association schema

Description

schemaCox() defines the result and artifact contract for right-censored Cox proportional-hazards models produced by associate$regression(model = “cox”).

Usage

schemaCox()

Value

A schema definition list.

Result semantics

Cox rows represent coefficient-level tests on the log-hazard scale. For a categorical predictor with k levels, the result table contains k - 1 contrast rows relative to the reference level.

outcome: endpoint/event-of-interest indicator.
time: observed time or age at event or censoring.
predictor: tested predictor.
term: coefficient term retained for the tested predictor or requested interaction.
term.type: main for predictor coefficient rows or interaction for predictor-by-modifier coefficient rows.
effect.scale: log.hazard.
estimate: log hazard ratio. Forest plots exponentiate this to a hazard ratio.
se, lower, upper: standard error and confidence interval on the log-hazard scale.
statistic: z statistic.
p.value, adj.p.value: raw and adjusted coefficient p-values.
n, n.events: complete observations and endpoint events used by the model.
formula: displayed Cox formula.

Artifacts

Optional observed.curves contains aggregate observed survival curves. Optional predicted.curves contains adjusted model-predicted survival curves for explicit prediction profiles. Optional prediction.grid records those profiles. Optional risk.table and group.summary provide information tables for survival plots.