From question to analysis plan
You will learn to choose the health question a table can answer, then write a short plan that makes the answer checkable. The outcome is not a test name: it is a stated comparison, an estimated effect, and an honest account of uncertainty.
Start with the clinic decision
A clinic adds six weeks of discharge support. Its follow-up table has one row per person: group, symptom score at discharge, and symptom score six weeks later. The team must decide what to report before reading a result.
- Question A: At six weeks, how do the support and usual-care groups differ?
- Question B: How much did each person’s symptoms change from discharge?
- Question C: How do the groups differ in their change from discharge?
Choose Question A when the clinic’s decision is which group had lower symptoms at the scheduled follow-up. Question B describes change within people; it does not compare the groups. Question C compares change, so it is appropriate only when that is the decision the clinic wants to make. The same table can support all three, but it cannot make them the same question.
How the same question may appear in a paper
You have already stated the population, comparison, outcome, and time in ordinary language. Some papers compress those parts into PICO: Population, Intervention, Comparator, Outcome. Here that means eligible adults leaving the clinic; the support program; usual care; and symptom score at six weeks. For a non-randomized exposure question, PECO changes Intervention to Exposure. Use the acronym as a reading aid, not as a substitute for the complete question.
The estimand is the exact effect or question the data must estimate. For Question A: the mean symptom-score difference at six weeks, support minus usual care, among eligible adults. An estimate is the number calculated from this sample for that target. The unit of analysis is what one row contributes: here, one participant, not one clinic visit. A confidence interval (CI) is the range of effect sizes compatible with the data and stated assumptions; it shows uncertainty, not whether the program is clinically proven.
Write a plain-language analysis plan
A plan records the choices before a result can tempt you to change the question. Begin with ordinary language:
Comparison: discharge support versus usual care.
Outcome and time: symptom score six weeks after discharge.
Unit: one participant.
Effect: mean score in support minus mean score in usual care.
Missing scores: record them and state the rule before analysis.
The plan chooses Question A. “Before and after” would answer Question B instead; “change in each group” would answer Question C unless it explicitly compares those changes. A negative support-minus-usual-care estimate would mean lower average symptoms in the support group; the CI would show how uncertain that estimated difference remains. This is a teaching decision, not evidence that the program works.
which question does this plan answer?
Try a new decision without code
A community clinic must choose between phone and text-message check-ins for people starting blood-pressure medicine. Its table has one row per person: check-in format and whether the person is taking the medicine as prescribed 14 days later. Write five lines: population, comparison, outcome and time, unit, and effect.
one defensible plan
Keep later complications in view, not at the entrance
Later modules add data integrity, missing-data assumptions, diagnosis, and reporting. In trials, an intercurrent event—for example, stopping treatment or starting rescue therapy—can change which question is being answered. ICH E9(R1) is a public extension for that planning problem. For now, record such events and do not silently switch the question after results appear.
Optional technical practice: AURORA-30
AURORA-30 is a fictional practice cohort. You do not need it, JSON, or code to understand this module. If you want to test the plan mechanically afterward, the optional lab checks whether a synthetic plan names its target, unit, time, and evidence.
{
"population": "eligible synthetic participants",
"comparison": "support minus usual care",
"outcome": "symptom score at 6 weeks",
"unit": "participant",
"estimand": "mean difference at 6 weeks"
}
analysis-plan-contract
Validate a synthetic analysis plan. It is practice only; no clinical data, account, or download is required.
python analysis_plan_contract.py --input samples/aurora30_plan.json --out analysis_plan.json --format jsonwhat should make you pause before choosing a method?
- Choose the decision first; the same table can answer different questions.
- Acronyms can help you read a paper, but the plan must state the exact effect.
- A plan records the comparison, unit, time, effect, uncertainty, and limit before analysis.