← Outbreak Files

Methodology

How the figures on Outbreak Files are gathered, checked and summarised, how the home page orders outbreaks, and what the site deliberately does not do. The formulas behind each indicator are on the Data & API page.

Where the figures come from

Each outbreak has one of two kinds of source, shown on its card.

Automatic and hand-curated sources compared
Read automaticallyCurated by hand
SourceThe outbreak’s Wikipedia infobox, which cites the health ministries and WHO.Official situation reports, each with its source.
CoversHeadline totals and the chart.Milestones, country and province tables, map bubbles and written summaries.
UpdatedTwice a day (08:00 and 20:00 UTC).When we enter a report. It does not update on its own.
Card showsWhen the source was last checked.The date the figures were last verified.
How to trace itEvery reading links to the exact Wikipedia revision. The raw infobox text is archived with a SHA-256 fingerprint, so any number can be re-checked later.The official report is linked on each entry.

Hand-checked milestones are merged with the automatic readings for the headline totals and the chart. On a day with both, the hand-checked figure wins.

Countries that only the news has linked to an outbreak are labelled Unverified until an official source confirms them.

Checks before a reading is kept

Sanity checks applied to each new reading
CheckRuleException
No decreasesConfirmed cases, deaths and recoveries never go down.None.
Largest jumpConfirmed cases or deaths may not rise by more than 25% over the previous reading.Not applied when the previous reading is more than 7 days old.
Deaths and casesDeaths may not exceed confirmed cases.None.

A reading that fails a check is rejected and logged, and the previous figures stay on the page.

Historical import. When older history is imported, edits that break these rules (typos, vandalism, edits in progress) are dropped and the longest consistent run of readings is kept.

Reporting lag and the 7-day trend

Sources are updated in batches, so the most recent days often show no new cases simply because the report has not been entered yet. Measured naively, that looks like a sudden collapse. Every 7-day count therefore ends on the latest day the total actually moved, but never more than 3 days before the newest reading, so a real halt in cases still shows up. Days without a reading are filled in a straight line between their neighbours.

Each card leads with a plain-language result for the trend: it compares new confirmed cases in the last 7 days with the 7 days before. There are five possible results:

Trend results shown on a card and when each is shown
Result on the cardWhen it shows
Cases are risingThe whole 95% range of the growth rate is above zero.
Cases are fallingThe whole 95% range of the growth rate is below zero.
No clear rise or fallThe 95% range of the growth rate includes zero.
Too few new cases to judge a trendToo few new cases in the 7 days to judge a trend.
Not enough data for a trend yetFewer than 5 readings in the last two weeks, or less than 14 days of history. Shown instead of guessing.

On an outbreak’s dashboard the same five results appear as a badge: Growing, Declining, Plateau, Unclear or Not enough data. The bar chart on each card shows new confirmed cases per 7-day period, newest on the right, and the result and counts beneath it describe the newest bar.

Rates use only the automatic daily readings, never the hand-entered milestones, so a change of source cannot create a false jump.

How the home page orders outbreaks

The home page is titled “Outbreaks we are tracking”, not “the worst outbreaks in the world”: it covers only the outbreaks we follow. They are ordered by a fixed rule. First, by status group, in this order:

Status groups in the order the home page shows them
Status groupMeaning
1.ActiveCases are still being reported and the outbreak has not been declared over.
2.Under watchA signal worth following that has not yet been confirmed as an outbreak.
3.WaningTransmission has slowed sharply; authorities are counting down to declaring it over.
4.Declared overDeclared over by the health authorities. Kept as a permanent record.

Then, within each group:

  1. Most new deaths in the last 7 days first.
  2. Ties are broken by most new confirmed cases in the same 7 days, then alphabetically.
  3. Outbreaks without enough history for a 7-day count come last in their group.

There is no editorial pinning and no combined severity score.

We will revisit the rule once more than about six outbreaks are tracked, and any change will be dated on this page.

Comparing outbreaks

Outbreaks are counted differently: case definitions, testing capacity and reporting delays vary by disease and by country, and some sources report suspected cases while others report only confirmed ones. Two totals side by side are rarely like for like. Each card shows its own source and as-of date; compare the direction of each trend rather than the size of the numbers.

What we do not do

  • No forecasts. Every indicator describes the recent past and depends on how complete reporting is.
  • No medical or travel advice. For decisions, follow WHO and your national health authority.
  • No single “severity” score across diseases.
  • The reproduction number (Rt) relies on a serial interval measured for a specific disease, so it is shown only where one is available; the values used are listed on the Data & API page.

Found an error? See corrections.