# Contexte de quartier — tables de proximité et socio-éducatives

Base construite : `data/staging-contexte.db` (SQLite, ~2,3 Mo)
Script : `scripts/build_contexte.py` (reconstruction complète, sources téléchargées dans `/tmp/louka-ctx`, option `--clean`)
Date de construction : 2026-08-08

## Tables

### 1. `da_pmd` — mesures de proximité par aire de diffusion (13 805 AD)

Source : Statistique Canada, **Base de données sur les mesures de proximité (PMD) 2021**, no 17-26-0002, édition 2023 ([page StatCan](https://www150.statcan.gc.ca/n1/pub/17-26-0002/172600022023001-eng.htm), [gouvernement ouvert](https://open.canada.ca/data/en/dataset/3bac0d69-e46e-43fd-bd39-6e77f9a30319)). Licence du gouvernement ouvert – Canada.

- Fichier national par **îlot de diffusion** (DBUID, ~498 500 lignes), lu en streaming.
- Filtre Québec : `DAUID` commençant par `24` (le fichier fournit directement la colonne DAUID = 8 premiers caractères du DBUID).
- **Échelle d'origine** : les colonnes `prox_idx_*` sont déjà **normalisées 0..1 par StatCan** (transformation min-max, à l'échelle nationale, des mesures brutes de proximité pondérées par la gravité/distance réseau). `..` = valeur indisponible. Aucune re-normalisation n'a été faite ; un garde-fou borne à [0, 1].
- **Agrégation DB → AD** : moyenne **pondérée par la population de l'îlot (`DBPOP`)** des valeurs non nulles ; si aucun îlot peuplé de l'AD n'a de valeur, repli sur la moyenne simple des valeurs non nulles ; sinon `NULL`.

| colonne | source PMD | non-null | min | max |
|---|---|---|---|---|
| prox_epicerie | prox_idx_grocery | 12 118 | 0.0002 | 0.6850 |
| prox_pharmacie | prox_idx_pharma | 8 153 | 0.0010 | 0.5124 |
| prox_garderie | prox_idx_childcare | 13 097 | 0.0003 | 0.9218 |
| prox_ecole_prim | prox_idx_educpri | 11 731 | 0.0025 | 0.6288 |
| prox_ecole_sec | prox_idx_educsec | 6 692 | 0.0029 | 0.5733 |
| prox_sante | prox_idx_health | 13 254 | 0.0000 | 0.3740 |
| prox_bibliotheque | prox_idx_lib | 5 132 | 0.0036 | 0.5912 |
| prox_parc | prox_idx_parks | 12 718 | 0.0001 | 0.8381 |
| prox_transport | prox_idx_transit | 9 218 | 0.0000 | 0.4293 |
| prox_emploi | prox_idx_emp | 13 681 | 0.0000 | 0.5869 |

Les maximums < 1 sont normaux : la normalisation est nationale, les valeurs 1.0 se trouvent dans les centres les plus denses du Canada (Toronto/Vancouver), et l'agrégation par AD lisse les pointes.

### 2. `da_defav` — défavorisation INSPQ 2021 (13 806 AD, 12 974 cotées)

Source : INSPQ, **Indice de défavorisation matérielle et sociale 2021**, tableau d'équivalence complet, version avril 2024 ([Données Québec](https://www.donneesquebec.ca/recherche/dataset/indice-de-defavorisation-du-quebec-2021)). Licence CC-BY 4.0.

- `quintile_materiel` / `quintile_social` = colonnes `QuintMat` / `QuintSoc`, **échelle Québec** : 1 = plus favorisé … 5 = plus défavorisé. 832 AD non cotées (`NULL`) : population trop faible, milieux institutionnels, données de recensement supprimées.
- **Surprise de format** : le jeu Données Québec ne publie le tableau d'équivalence qu'en **XLSX** (`1. TableCorrespondancesCompleteQuebec2021_fr.xlsx`, feuille « Données »), pas en CSV — lu en streaming avec `openpyxl` (mode read_only). Les AD scindées entre plusieurs CLSC apparaissent en doublon dans le tableau ; les quintiles « échelle Québec » y sont identiques (première occurrence conservée).

### 3. `ecoles` — 2 664 écoles primaires/secondaires géocodées (100 %)

Sources ([localisation MEQ-MES](https://www.donneesquebec.ca/recherche/dataset/localisation-des-etablissements-d-enseignement-du-reseau-scolaire-au-quebec), [indices de défavorisation MEQ](https://www.donneesquebec.ca/recherche/dataset/indices-de-defavorisation), CC-BY 4.0) :
`pps_public_ecole.csv` (1 ligne/immeuble), `pps_prive_installation.csv` + `pps_prive_etablissement.csv`, `defav_ecole_prim_public.csv` et `defav_ecole_sec_public.csv` (année scolaire **2025-2026**).

- **Choix de clé (organisme vs bâtiment)** : `code` = **code d'ORGANISME MEQ** (`CD_ORGNS`, 7 chiffres, zéros de tête préservés), car c'est la clé des fichiers IMSE/SFR (`Code_Org`). Les écoles multi-bâtiments sont réduites à une ligne ; `lat`/`lng` = premier immeuble (public) ou première installation (privé) géocodé, WGS84 (`COORD_X_LL84` = longitude).
- Filtre : `PRIM=1` ou `SEC=1` (préscolaire seul, formation professionnelle et éducation des adultes exclus). `ordre` ∈ {primaire, secondaire, primaire-secondaire}.
- Répartition : public 2 434 (1 844 prim / 389 sec / 201 mixte), privé 230 (58 / 89 / 83).
- `imse` / `sfr` = déciles 1 (favorisé) à 10 (défavorisé). 2 287 écoles publiques avec IMSE (2 287 / 2 290 codes diffusés matchés = 99,9 % ; 3 codes du fichier défav absents de la localisation — écarts de millésime). `NULL` pour le privé (non publié) et pour les écoles publiques sous seuil de diffusion. Une école présente dans les fichiers primaire ET secondaire reçoit les déciles du fichier **primaire**.

### 4. `meta` — 12 clés (sources, licences, notes méthodologiques)

## Validations

| exigence | résultat |
|---|---|
| da_pmd ~10-13 k AD 24* | **13 805** (l'ensemble des AD du QC 2021 est ~13,8 k) ✅ |
| valeurs 0..1 | toutes les colonnes dans [0.0000, 0.9218] ✅ |
| da_defav ≥ 90 % des AD urbaines | **95,6 %** (proxy urbain : AD avec mesure de transport en commun dans la PMD) ✅ |
| ecoles ~3 000 | **2 664** — après exclusion presc/FP/adultes et regroupement multi-bâtiments par organisme ✅ (2 434 pub + 230 priv, 100 % géocodées) |
| IMSE plausible | Limoilou : Stadacona **9**, Saint-Paul-Apôtre **7** ; Sillery/Ste-Foy : Les Sources **1**, De Rochebelle **2** ✅ |

**Nuance intéressante** : École Saint-Fidèle (Limoilou) affiche IMSE **2** — vérifié conforme au CSV source 2025-2026 (IMSE brut 3,88, SFR décile 8). La gentrification de Limoilou se lit dans les millésimes récents ; le contraste attendu reste net sur Stadacona/Saint-Paul-Apôtre.

## Surprises de format rencontrées

1. `PMD-en.csv` est encodé en **Latin-1** (pas UTF-8) — noms de lieux accentués.
2. Le tableau d'équivalence INSPQ n'existe qu'en **XLSX** (pas de CSV publié).
3. Les mesures PMD manquantes sont codées `..` ; `prox_bibliotheque` et `prox_ecole_sec` sont les plus creuses (~37 % et ~48 % de non-null seulement).
4. Fichiers privés MEQ : les ordres d'enseignement (PRESC/PRIM/SEC) ne figurent que dans le fichier **installations**, pas dans le fichier établissements — jointure via `CD_ORGNS_RESP`.

## Attributions

- Contient de l'information visée par la **Licence du gouvernement ouvert – Canada** (Statistique Canada, PMD 2021).
- « Indice de défavorisation matérielle et sociale 2021 », INSPQ — **CC-BY 4.0**.
- Données du ministère de l'Éducation du Québec (localisation des établissements ; indices IMSE/SFR) — **CC-BY 4.0**, Gouvernement du Québec.