startthat.work home

MM-05 Survival and duration analysis (Kaplan-Meier estimator; Nelson-Aalen estimator; Cox proportional hazards; time-to-event analysis)

Estimate the time until an event while using records whose event has not yet been seen, and produce survival curves with intervals and a median duration.

Measure and modelEvidence: DocumentedPrimary technique, runs in step 5.3Strongest statement: show a link between things

What it does

Estimates the time until an event while using records whose event has not yet been observed. Artefact: a survival curve with intervals and a median duration. Read curve separation and censoring counts.

When to use it

Use when you need to know how long something lasts or how fast an event happens and some cases are still ongoing.

When it does not fit

Needs durations with an event flag. Misfit: heavy censoring, or non-proportional hazards for Cox models (not confirmed).

Result format

The result has a survival curve with intervals, a median duration, and the counts of records with an observed event and of censored records. It states whether the curves for the compared groups separate.

Requirements on the material

PropertyRequirement typeRequirement
StructureApplies in some casesrequires=structured
Content typeAlways appliesrequires=tabular
Unit of analysisAlways appliesrequires=record
Variable typesRaises a warningprefers=ratio; prefers=nominal
Time structureApplies in some casesrequires=panel; requires=cohort; requires=continuous stream
Level of detail availableAlways appliesrequires=record-level
Appraises source credibilityApplies in some casesno

Not restricted on: How the sample was chosen, Number of sources, Whether sources can be joined, Amount of material, Known data problems, Producer interest, Source dependence, Origin, Document genre, Language, Personal information, Security classification, Licence.

Minimum materialat least 30 records with a start date, an end or last-seen date and an event flag
Additional sources needednone
Not for (rules)none
Not for (text)Wrong choice when there is no event flag or when most records are censored. Cox models also assume proportional hazards, which was not confirmed in the source.

Choosing and ordering

Kind of techniquePrimary technique, runs in step 5.3
Phase taganalyse
Other phase tagsnone
Kind of findingtrend; difference
Question answeredhow much; what next
Strongest statement it supportsshow a link between things
Needs as input
Makes as output
Must exist firstNone
Loop targetreturn to verify and prepare

Library checks by stakes

Each stakes level includes the checks of the level below it. Checks that need a person apply at high stakes only, so the process leaves them out at lower stakes (decision 38). Repeatability: deterministic.

StakesCheckPerson involvedCounts as a different method
exploratoryinput validationnoneno
decision-informinginput validationnoneno
decision-informingcode execution for arithmeticnoneno
decision-informingsensitivity analysisnoneno
high-stakesinput validationnoneno
high-stakescode execution for arithmeticnoneno
high-stakessensitivity analysisnoneno
high-stakesassumption and limitation statementnoneno
high-stakessecond technique with different assumptionsnoneconditional

Failure modes and limits

Model suitabilitymodel plus code
Typical model failureIgnores censoring and averages the observed durations.
Error sourcesinput data; statistical assumptions
Certainty limitsCertainty drops with heavy censoring or few events (imprecision), when censoring is related to the outcome (risk of bias) and when hazards are not proportional for Cox models (inconsistency).

Evidence and tag basis

Documented. The only source read is a software package page. It names the estimators and shows an event-observed flag, but it does not define censoring. (lifelines on PyPI)

Tag basis: input profile inference; selection inference; sequencing inference; robustness inference. All tag values are inference unless a source is named.