# Rahvastiku jaotamine (OSM-hooned)

## Eesmärk

Määrata igale teede sõlmele "rahvastikukoormus" — kui palju inimesi elab selle sõlme läheduses. See on liikumiste genereerimise (trip generation) aluseks.

## Meetod (alates 2026-08: OSM-hooned)

### 1. Hoonete laadimine

```python
bld = ox.features_from_polygon(boundary, {"building": True})
bld = bld[bld["addr:housenumber"].notna()]   # ainult aadressiga = eluruumid
```

- **Aadressiga hooned** = tegelikud eluruumid. Hõreasustuses on palju suvilaid/abihooneid (greenhouse, shed, garage...) ilma aadressita — need välistatakse.
- Skript: `pipeline/building_population.py`

### 2. Hoonete omistamine sõlmedele

```python
dists, idxs = node_tree.query(bld_xy, k=1)   # iga hoone lähim sõlm
if dist <= 300: node_population[node] += persons
```

Iga hoone → **lähim tee sõlm** (max 300 m). Ei loeta hoonet mitu korda.

### 3. Elanike arv hoone kohta

```python
PERSONS_PER_BUILDING = 2.2    # Eesti keskmine leibkond
PERSONS_PER_APARTMENT = 12.0  # korterelamu
```

### 4. Rahvastiku liitmine väljapääsupunkti teenindusalale

Kasutades teenindusala jaotust, summeeritakse iga väljapääsupunkti teenindusala rahvastik.

### 5. Trippide genereerimine (trip generation)

```python
TRIPS_PER_PERSON = 2.0
daily_trips_to_exit = population_catchment * TRIPS_PER_PERSON
```

## Väljundid

- `{prefix}_pop_node_population.csv` — sõlme-taseme rahvastik (node, population)
- `{prefix}_catchment.csv` — `exit_node, population_catchment, nodes_served, ...`
- `{prefix}_pop_vulnerability.csv` — rahvastikupõhine haavatavus
- `{prefix}_critical_edges.csv` — kriitilised lõigud

## Miks mitte WorldPop?

WorldPop-i 100 m raster omistab rahvastiku **lähimale sõlmele kuni 5 km** kaugusel. Otepääl sai põllutee sõlm 281707587 (Otepää linna serv, Kanepi tee ristmik) 40.5 elanikku, kuigi teedegrupil OTE_0141 pole maju. Hoonepõhine hinnang annab sellele 0 elanikku — täpselt nagu tegelikkuses.

## Täpsus

- Aadressiga hoonete arv × 2.2 annab valla kogurahvastiku lähedase hinnangu (Valga 17 348 vs ~16k, Otepää 6 607 vs ~6.7k, Võru 9 622 vs ~10k)
- Piirangud: OSM-i hõlmatus (mitte kõik majad on kaardistatud), korterelamute suurus hinnanguline