- **Script** : premier panneau de `python3 src/cellular/all_analyses.py [CSV ou dossiers]` (défaut : `data/WEISSHORN/` et `data/NORDEND/`, D-032), qui écrit `out/<STATION>_cellular.html` et l'ouvre.
- **Code** : `src/cellular/link_state.py` (`run()`, `day_facts()`, `by_day()`), bibliothèque standard uniquement, sans import du projet. Les séries viennent de `common.stations.load_stations`, qui charge `link` et `last_sync` comme la liste des échantillons de l'heure (D-031).
Chaque jour, les envois de la station sont-ils tous arrivés, complets, avec le lien 4G actif ?
- **Lien avec la question du domaine** (`docs/cellular/domaine/point-de-depart.md`) : des données qui arrivent est le premier service de la 4G. Ici, comme pour Energy, un envoi absent peut être l'anomalie elle-même.
- **Ce que l'analyse ajoute** : elle ne dépend d'aucun seuil radio ni d'aucun historique ; elle vaut dès le premier jour d'installation, comme `DAILY_BATTERY_STATE` (D-018).
## Principe
Le collecteur écrit `link = up` quand le contexte de données du modem a une adresse IP (`get_modem_info`, `docs/aimsight/collecteur_system_info.py`), et `sync` envoie un instantané toutes les 15 minutes, un message par métrique (`cmd_sync`). Deux de ces messages partent à chaque envoi, quel que soit l'état du modem : `link` (`down` si la lecture échoue) et `last_sync` (toujours le dernier). On compte, jour par jour, les envois reçus, les messages perdus dans un envoi reçu, et la valeur de `link`.
Les exports d'une version plus ancienne du collecteur (NORDEND) n'ont pas `link` : les envois se comptent alors sur `last_sync` seul, et ce qui dépend de `link` vaut `None`.
Calcul exact, pour chaque jour UTC d ayant au moins une ligne `link` (sinon `last_sync`) :
2.`n_up`, `n_down` = nombre d'échantillons `up` et `down` du jour (`None` sans `link`). `n_sends` = envois reçus, doublons compris (le plus grand des deux comptes, heure par heure).
3.`n_missing` = envois entiers perdus : somme, heure par heure, de `SAMPLES_PER_HOUR`− le plus grand des deux comptes (un envoi est arrivé si l'un de ses deux messages est arrivé ; jamais négatif : un doublon ne bouche pas le trou d'une autre heure).
4.`n_messages_lost` = messages perdus dans un envoi arrivé : somme, heure par heure, de |compte `link`− compte `last_sync`|. `None` si l'une des deux séries manque.
5.`received_percent` = (envois attendus −`n_missing`) / envois attendus, et `up_percent` = `n_up` / envois attendus, en %, avec envois attendus = `SAMPLES_PER_HOUR`× 24. `None` sur un jour coupé (moins de 24 heures).
| 1 bis | aucun envoi reçu avant ce jour (jour du premier envoi compris) | `None` (UNKNOWN) | début d'historique, pas une coupure (`docs/domaine/pieges-des-donnees.md`) ; calcul causal : seuls les jours ≤ d comptent |
| 2 | `n_down` ≥ 1 (jamais sans `link`) | `DOWN` | le modem a signalé le lien coupé au moins une fois, et cet envoi est quand même arrivé (remontée différée ou autre voie) |
| 3 | `n_missing` ≥ 1 ou `n_messages_lost` ≥ 1 | `MISSING` | des envois ou des messages manquent ; la cause n'est pas établie (lien, coupure d'énergie, réception côté serveur) |
| 4 | sinon | `UP` | tous les envois sont arrivés, lien actif |
Sortie (contrat commun) : un point par jour.
-`t` = dernière heure du jour présente dans la série.
| `SAMPLES_PER_HOUR` | 4 | **Cadence observée, non documentée** : un envoi toutes les 15 minutes, d'après `last_sync` (WEISSHORN : 900 ± 1 s dès le 01/09, sauf 4 intervalles, après une cadence irrégulière de 880 à 899 s du 19 au 31/08 ; NORDEND : 9 498 intervalles sur ~9 800). Ni le collecteur (`cmd_sync` est lancé de l'extérieur) ni la doc AIMsight ne la fixent ; la FAQ cite « one measurement every 15 minutes », mais c'est le rythme des acquisitions de la caméra, réglé par le client. À confirmer (`docs/cellular/domaine/questions-pour-l-expert.md`). |
- **En haut** : `received_percent` par jour, placé à midi UTC (D-019), un marqueur par état (couleur, symbole et légende propres ; couleurs validées par le skill dataviz).
- **Site** : le même panneau, en anglais (D-023), dans la figure du site `src/cellular/final.py` (historique complet du bloc Cellular de la vue client, D-039) ; la page de comparaison l'importe de là.
- 09/08 au 19/08 : UNKNOWN, début d'historique ; premier envoi le 19/08 à 09:00, avec `link = down` (le modem cherche le réseau).
- 20/08 : `DOWN`, fin de la mise en service : un échantillon `down` à 10:00, au retour d'un trou de 18 h ; 43 envois manquants.
- 21/08 au 12/10 : 46 jours `UP`, 6 `MISSING`, 1 `DOWN`.
-`MISSING` : un envoi manquant entre 01:00 et 02:00 UTC les 29/08, 30/08, 01/09, 05/09 et 06/09 ; trois le 22/08 à 17:00 et 19:00, pendant des écritures sur `/data`.
-`DOWN` le 03/09 : un seul échantillon `down` à 15:00, alors que les 96 envois sont arrivés. Avec la règle « un `down` suffit », un état fugitif du modem colore la journée.
- 13/10 : UNKNOWN, coupé par l'export.
- Contrôle du compte sur des copies modifiées en mémoire, fait sur l'export de 10 jours (rien d'écrit) : un message `link` ou `last_sync` retiré donne `n_messages_lost` = 1 ; les deux retirés, `n_missing` = 1 ; sans série `last_sync`, `n_messages_lost` = `None`.
NORDEND (109 jours, sans `link`, du 26/06 au 13/10) :
- 76 jours `UP`, 29 `MISSING`, 5 UNKNOWN (26 au 29/06 : début d'historique, premier envoi le 29/06 à 07:00 ; 13/10 : coupé par l'export).
- Les `MISSING` lourds sont les coupures de 1 à 23 h : 30/06 (95 envois manquants), 01/07 (55), 10 au 13/07 (8 à 62), 22-23/07 (43 et 33), 19 au 22/08 (12 à 23). La tension reste de 13,94 à 14,37 V au retour, sans redémarrage à 12,6 V : cohérent avec une station alimentée.
- Les autres `MISSING` ont 1 à 5 envois manquants : fin août et début septembre surtout (26/08 au 06/09).
- Aucun cas annoté par l'expert : aucun `DOWN` vu (impossible sans `link`) ; les `MISSING` ne sont pas encore confirmés.
| Compter les heures où le RSRP est présent | Une heure avec 1 instantané sur 4 paraît complète ; `link` donne le compte exact. |
| Comparer toutes les métriques texte | `registration`, `network_*` et `ip` sont vides, donc pas envoyés, quand la lecture du modem échoue ou que le lien tombe : leur absence n'est pas une perte. |
| Compter les messages des métriques numériques | Moyennes horaires : le nombre de messages n'est pas dans l'export. |
| Tolérer un envoi manquant par jour | Aucune donnée pour le calibrer ; le compte reste dans `facts` pour en décider avec les cas de l'expert. |
| Déduire le lien des champs du modem sur NORDEND | Sans `link`, un envoi sans `network_technology` peut être une lecture du modem qui échoue (26 % des heures depuis juillet) ; ce n'est pas un lien coupé. |
2.**`MISSING` ne dit pas pourquoi** : une coupure d'énergie fait aussi manquer les envois. Le croisement avec Energy reste à faire, au plus tard dans la couleur du jour.
3.**Remontée différée** : sur NORDEND, rien n'arrive plus tard dans les heures des coupures (les envois y sont rangés à l'heure de la station) ; les envois perdus le restent. Une coupure du lien y apparaît donc comme `MISSING`.
4.**Un instantané toutes les 15 minutes** : une coupure plus courte entre deux envois n'est pas vue.
5.**Le jour en cours est UNKNOWN** jusqu'à sa dernière heure.
6.**Un message `link` absent n'est pas toujours perdu en route** : si le collecteur s'arrête plus de 120 s pendant que `sync` tourne, la réponse du modem expire dans Redis et `link` n'est pas envoyé. Cela compte aussi dans `n_messages_lost`.
7.**Seuls deux messages par envoi sont comptés** : la perte d'un autre message (une mesure radio, la tension) n'est pas vue.
8.**Sans `link`** (NORDEND) : ni `DOWN`, ni `up_percent`, ni `n_messages_lost` ; seuls les envois entiers manquants se voient.
9.**Comptage par heure** : un envoi décalé d'une seconde change d'heure, et un envoi en surnombre bouche un trou de sa propre heure (NORDEND en fait 5 à 7 par heure vers 06:00 et 09:00 UTC). Sur NORDEND, le 15/07 sort `MISSING` à tort (l'envoi de 09:00 est parti à 08:59, rangé dans l'heure de 08:00) et le 28/07 compte 1 envoi manquant au lieu de 2. Les 16 autres petits `MISSING` sont justes.
10.**Cadence supposée fixe** : 4 envois par heure sur toutes les stations. Une station réglée autrement (30 min, 1 h) sortirait `MISSING` tous les jours.
- **Deux corrections retenues sur le principe (2026-10-13), non codées** : l'utilisateur veut d'abord voir avec le spécialiste comment articuler le code.
1.**Compter par quart d'heure** (limite 9) : ramener chaque horodatage de `last_sync` au quart d'heure le plus proche (08:59 → 09:00, 06:19 → 06:15), puis compter les quarts d'heure distincts reçus dans la journée. Effet mesuré sur NORDEND : le 15/07 passe `UP`, le 28/07 reste `MISSING` avec 2 envois manquants, rien d'autre ne change.
2.**Mesurer la cadence de chaque station** (limite 10) : l'intervalle le plus fréquent entre ses envois des jours précédents (calcul causal), à la place de `SAMPLES_PER_HOUR`. 15 min sur WEISSHORN et sur NORDEND.
- Points d'articulation à trancher : `link` n'a pas d'horodatage propre (un compte par heure), alors que la correction 1 compte par quart d'heure sur `last_sync` : comment garder `n_messages_lost` cohérent ; cadence mesurée par l'analyse, ou lue dans la configuration de la station si elle y est.
- **Journal de la station** : `cmd_sync` y écrit le nombre de messages de chaque envoi. S'il devient accessible, le comparer à ce qui arrive donnerait les pertes réelles, et séparerait « pas envoyé » de « perdu en route » (question 6 de `docs/cellular/domaine/questions-pour-l-expert.md`).
- **Renommer les états**, proposé le 2026-10-13, non décidé : `UP` se lit « lien actif », alors que sans `link` (NORDEND) il veut seulement dire « tous les envois sont arrivés ». Proposition : `COMPLETE`, `INCOMPLETE`, `LINK_DOWN`.
-`registration` (`searching`, `denied`) pourrait expliquer un `DOWN`.
## Historique
- **2026-10-13** : création, avec le chargement des métriques texte par `common.stations` (D-031).
- **2026-10-13** : ajout de `n_messages_lost` (messages perdus dans un envoi arrivé, `link` comparé à `last_sync`), qui mène aussi à `MISSING` ; `n_missing` compte désormais un envoi comme arrivé si l'un de ses deux messages est arrivé.
- **2026-10-13** : `link` facultatif (exports sans `link`, NORDEND) ; `value` devient `received_percent` ; ajout de `n_sends` ; début d'historique en UNKNOWN ; pourcentages `None` sur un jour coupé (D-032).
- **2026-10-13** : limites 9 (comptage par heure) et 10 (cadence supposée) ; deux corrections retenues sur le principe, non codées, en attente du spécialiste (« Pistes »).
- **2026-10-13** : panneau en anglais, partagé avec la figure du site `src/cellular/final.py` ; livraison du domaine (vue client, notifications, guide `docs/cellular/guide/`, D-039).