# Під тривогою — відкриті дані

Агреговані дані про повітряну загрозу в Україні, зібрані з публічних джерел.

## Файли

| Файл | Що всередині |
|---|---|
| `threat_mentions_by_month.csv` | Скільки разів кожен населений пункт згадували в оперативних попередженнях Повітряних Сил, по місяцях і типах цілі |
| `missile_alerts_by_oblast.csv` | Оголошення ракетної небезпеки по областях |
| `nightly_summaries.csv` | Ранкові зведення ПС ЗСУ: скільки запущено, збито, на скількох локаціях влучання |
| `settlements_total.csv` | Підсумок по кожному населеному пункту за весь період |

## Як це читати — і як не треба

**Згадка не дорівнює влучанню.** Повітряні Сили називають населений пункт,
коли ціль летить у його бік. Більшість цих цілей збили або вони пройшли повз.

**Великі міста завищені.** Їх називають частіше не тому, що там небезпечніше,
а тому, що вони служать орієнтирами для опису курсу.

**Повнота джерела змінювалася.** У 2022 році публікували в рази менше
повідомлень, ніж зараз. Порожнеча в ранніх періодах — це брак даних, не спокій.

**Ракети майже не мають географії.** Ракетну небезпеку оголошують тільки
по областях: підлітний час балістики — хвилини, а маршрут крилатих
не оприлюднюють навмисно.

**Дрони не розкладені за типами.** З 2025 року ПС пишуть одним числом
на весь пакет, де змішані «шахеди», «Гербери», «Італмаси» та приманки.

## Методика

Повідомлення зібрано MTProto-клієнтом із публічного каналу Повітряних Сил ЗСУ.
Розбір тексту — правила на регулярних виразах. Прив'язка назв до координат —
довідник населених пунктів KSE (28 658 записів) з урахуванням українських
відмінків і чергування і/о. Для неоднозначних назв (Іванівок у довіднику 116)
застосовано топологічний метчинг: обирається та, що ближча до маршруту цілі
за попередні години.

Точність прив'язки топонімів — близько 99%. Перевірено вручну на топ-30 назв.

## Джерела

- Сповіщення про тривоги: [Vadimkin/ukrainian-air-raid-sirens-dataset](https://github.com/Vadimkin/ukrainian-air-raid-sirens-dataset)
- Довідник населених пунктів: [KSE Loc Data Hub](https://github.com/kse-ua/KSE-Loc-Data-Hub)
- Межі районів і громад: [ukrainian_geodata](https://github.com/slawomirmatuszak/ukrainian_geodata)
- Оперативні повідомлення: канал Повітряних Сил ЗСУ

## Ліцензія

CC BY 4.0 — користуйтеся вільно, зазначайте джерело.