schemaCrr

Fine-Gray competing-risk association schema

Description

schemaCrr() defines the result and artifact contract for Fine-Gray competing-risk models produced by associate$regression(model = “crr”).

Usage

schemaCrr()

Value

A schema definition list.

Result semantics

Fine-Gray rows represent coefficient-level tests on the log-subdistribution 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 endpoint, competing event, or censoring.

  • competing: competing-event indicator.

  • 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.subdistribution.hazard.

  • estimate: log subdistribution hazard ratio. Forest plots exponentiate this to an SHR.

  • se, lower, upper: standard error and confidence interval on the log-subdistribution-hazard scale.

  • statistic: z statistic.

  • p.value, adj.p.value: raw and adjusted coefficient p-values.

  • n, n.events, n.competing: complete observations, endpoint events, and competing events used by the model.

  • formula: displayed Fine-Gray specification.

Artifacts

Optional observed.curves contains aggregate observed cumulative-incidence curves. Optional predicted.curves contains adjusted model-predicted cumulative-incidence curves for explicit prediction profiles. Optional prediction.grid records those profiles. Optional group.summary provides curve-level counts for information tables.