# Comptages Eco-Compteur de l'Isère — hackathon DGE

Données de fréquentation piétonne, cycliste et motorisée du département de l'Isère,
préparées pour le hackathon DGE / Isère Attractivité des 9 et 10 novembre 2026.

**Ouvrez `guide_donnees.html` en premier** : il explique ce que contiennent les fichiers,
comment lire les colonnes, et les pièges à connaître avant de conclure quoi que ce soit.

## Arborescence

```
diffusion/
├── LISEZMOI.md                  ce fichier
├── guide_donnees.html           guide de lecture — à ouvrir en premier
├── comptages/                   les données de comptage
│   ├── comptages_journalier_2025_2026.csv
│   ├── comptages_horaire_2025_2026.csv
│   ├── comptages_quart_heure_2025_2026.csv
│   └── historique_2021_2024.csv
└── sites/                       où sont les compteurs
    ├── sites_isere.csv          référentiel : position, modes, couverture
    ├── sites_valides_reconstruits.csv
    ├── carte_sites_2025_2026.html
    ├── carte_sites_2021_2024.html
    └── carte_sites_reconstruits.html
```

Les deux cartes sont des pages web autonomes : double-clic, elles s'ouvrent dans le
navigateur. Elles ont besoin d'une connexion pour afficher le fond cartographique.

## Les fichiers de comptage

| Fichier | Lignes | Sites | Période | Taille |
|---|---:|---:|---|---:|
| `comptages_journalier_2025_2026.csv` | 309 169 | 279 | 2025-01-01 → 2026-11-07 | 23 Mo |
| `comptages_horaire_2025_2026.csv` | 7 404 051 | 279 | 2025-01-01 → 2026-11-07 | 605 Mo |
| `comptages_quart_heure_2025_2026.csv` | 6 671 665 | 53 | 2025-01-01 → 2026-11-07 | 580 Mo |
| `historique_2021_2024.csv` | 499 016 | 338 | 2021-01-01 → 2024-12-31 | 36 Mo |

Tous ont les mêmes colonnes, à celle du temps près :

```
site_id, site_name, site_latitude, site_longitude,
date (ou date_time), user_type, direction, counts
```

**`comptages_journalier_2025_2026.csv`** — Total par jour. Le fichier par lequel commencer.

**`comptages_horaire_2025_2026.csv`** — Le même jeu, heure par heure.

**`comptages_quart_heure_2025_2026.csv`** — Pas de temps fin, pour les seuls compteurs qui remontent à cette fréquence.

**`historique_2021_2024.csv`** — Quatre années antérieures, au jour.

## Le référentiel des sites

`sites/sites_isere.csv` décrit les **417 compteurs** du département : position,
commune, gestionnaire, modes comptés, et surtout la **couverture temporelle** de chacun.

- 281 sites ont des données sur 2025-2026, dont **110** couvrant au moins 95 % des jours
- 338 sites ont des données sur 2021-2024, dont **85** couvrant au moins 95 % des jours

Les colonnes `couverture_*` et `periode_complete_*` servent à filtrer. Sur les cartes, les
sites à période complète portent un anneau orange.

## Trois pièges

**Les trous de données ressemblent à des baisses de fréquentation.** Un compteur posé en
cours d'année, tombé en panne ou démonté produit une série incomplète. Comparer deux sites
ou deux années sans vérifier d'abord leur couverture est l'erreur la plus fréquente.

**Le fichier au quart d'heure ne couvre que 53 sites.** Les compteurs ne remontent
pas tous à la même fréquence ; les autres n'ont pas de mesure plus fine. Pour une
couverture complète, travaillez à l'heure ou au jour.

**Certaines valeurs sont reconstruites.** Quand un compteur tombe en panne, les manques sont
parfois comblés à partir de compteurs voisins corrélés. Ces fichiers retiennent la meilleure
valeur disponible, mesure brute ou reconstruction, sans distinguer les deux. C'est le bon
choix pour des séries et des tendances, pas pour juger la qualité des capteurs.

**24 sites ont été validés manuellement et partiellement reconstruits** sur
2025-2026, 1 977 jours au total, dont 11 sites au-delà de 100 jours.
`sites/sites_valides_reconstruits.csv` les liste avec les modes concernés, le nombre de
jours et la fenêtre couverte ; `sites/carte_sites_reconstruits.html` les situe, la taille
du disque donnant l'ampleur. Sur les plus reconstruits, une part de la courbe est une
estimation et non une mesure — à savoir avant d'en tirer une conclusion.

## Modes comptés

| `user_type` | Mode | Lignes |
|---|---|---:|
| `pedestrian` | Piéton | 5 996 764 |
| `cyclist` | Vélo | 5 025 321 |
| `scooter` | Trottinette | 2 557 202 |
| `car` | Voiture | 713 323 |
| `vehicle` | Véhicule (générique) | 589 493 |
| `undefined` | Non renseigné | 1 398 |
| `bus` | Bus | 200 |
| `motorbike` | Moto | 200 |

## Directions

Un compteur a un ou plusieurs canaux. Quand il en a plusieurs, ils alternent entre les deux
sens de passage.

- `1` et `2` — les deux sens opposés d'un même site ; leur somme donne le trafic total
- `total` — le compteur n'a qu'un canal et ne distingue pas les sens

`1` et `2` ne disent pas lequel est l'aller et lequel est le retour, ni vers quel point
cardinal : cette information n'existe pas dans les données. En revanche, sommer `counts` sur
toutes les directions d'un site donne toujours le bon total, quelle que soit la convention.

## Ce que ces données ne disent pas

Un compteur enregistre des passages. Pas d'identité, pas de trajectoire, pas de provenance,
pas de destination. Les questions d'origine des visiteurs sortent de ce que ces fichiers
peuvent répondre.

## Licence et contact

Données produites par les gestionnaires de compteurs (collectivités, parcs, gestionnaires
d'espaces naturels) et mises à disposition par Eco-Compteur pour la durée du hackathon.
Conditions de réutilisation à préciser avec l'organisation avant toute publication.

Extraction du 7 novembre 2026. Horaires en heure locale.
