# hantavirus.one — open data

Structured data on the 2026 hantavirus outbreak. Released under CC BY 4.0
(see `LICENSE.txt`).

## Files

| File | Description |
|---|---|
| `summary.json` | Top-level aggregates: confirmed, suspected, deaths, countries, last update timestamp. |
| `countries.json` / `.csv` | One row per country. Confirmed cases, suspected cases, deaths, status, source URL. |
| `timeline.json` / `.csv` | Outbreak event log. Date, event description, source label, source URL. |
| `news.json` / `.csv` | Curated news headlines. Date, source, headline, outbound URL. |
| `sources.json` / `.csv` | Authoritative sources cited across the dataset, with license per source. |

## Schema

### `summary.json`
```
{
  "confirmed_cases":   integer,
  "suspected_cases":   integer,
  "deaths":            integer,
  "countries_affected": integer,
  "last_updated":      ISO-8601 string,
  "generated_at":      ISO-8601 string
}
```

### `countries.csv`
| Field | Type | Notes |
|---|---|---|
| iso | string | ISO 3166-1 alpha-2 |
| country | string | Display name |
| confirmed | integer | Lab-confirmed cases |
| suspected | integer | Suspected cases under investigation |
| deaths | integer | Deaths attributed to hantavirus |
| status | string | Free-text status note |
| source_url | URL | Primary source for this row |

### `timeline.csv`
| Field | Type | Notes |
|---|---|---|
| date | string | ISO-8601 (YYYY-MM-DD) |
| date_display | string | Human-formatted (e.g. "7 May 2026") |
| event | string | Event description |
| source_label | string | Short label for the source |
| source_url | URL | Link to source |

### `news.csv`
| Field | Type | Notes |
|---|---|---|
| date | string | ISO-8601 |
| date_display | string | Short display ("7 May") |
| source | string | Publisher |
| headline | string | Headline as published |
| url | URL | Direct link to original article |

## Update cadence

Maintained manually. Updated when authoritative sources publish revised
figures. The `summary.json` `generated_at` timestamp reflects the build time;
the `last_updated` field reflects the last time underlying numbers changed.

For authoritative real-time data, consult the WHO Disease Outbreak News
endpoint and ECDC threat assessments listed in `sources.csv`.

## Methodology

A row in `countries.csv` represents people physically present in or
formally connected to that country at the time of investigation. People
who transited through a country are not counted there. A confirmed case
requires laboratory confirmation by PCR or serology, as reported by a
national reference laboratory or by the WHO. Suspected cases are
symptomatic individuals under monitoring whose laboratory results are
pending or unconfirmed.

Deaths are attributed to a country based on where the death occurred,
not the nationality of the deceased.

Discrepancies between this dataset and the original sources are corrected
on the next update. Every row carries a `source_url`. If you find an
error, contact us through `/contact.html` on the site.

## Citation

> Data: hantavirus.one (CC BY 4.0). https://hantavirus.one/