Person-place-time epidemiology

Compute descriptive rates, an epidemic curve, and stratified patterns over an episode cohort, with denominators and ascertainment attached to every rate.

Research question

What are the attack rate, incidence, hospitalization, and case-fatality in this cohort, how does the epidemic curve look, and how do patterns differ across strata?

Who this is for

Public-health research teams summarizing cohort epidemiology
Hospital epidemiology researchers evaluating ward or setting patterns
Analysts who need rates reported with their denominators and caveats

Data requirements

Data	Required	Purpose
Infection episodes with case status and index date	Yes	Case counts and epidemic curve
Outcomes (severity, mortality)	Recommended	Hospitalization and case-fatality
Denominators (population at risk, person-time)	Recommended	Population rates rather than counts only

Workflow

Model episodes, outcomes, and denominators → Run epidemiology
  → Review rates, epidemic curve, and strata
  → AI interpretation

Step 1 — Compute rates

The Epidemiology analysis reports case counts, attack rate, incidence per person-time, hospitalization, and case-fatality. When no denominator is supplied, results are reported as counts only — never an implied population rate.

Step 2 — Curve and stratification

Review the epidemic curve by index date and stratify by a participant or episode attribute (sex, site, setting) to compare patterns across groups.

Expected outputs

Rates with denominators and ascertainment context
Epidemic curve of cases by date
Stratified case counts and a has_denominator flag