Files
Support-Agent/docs/cellular/analyses/daily_signal_state.md
T
maximeandClaude Opus 5.5 91ba1bd8ef Add the DAILY_LINK_STATE and DAILY_SIGNAL_STATE cellular analyses
Explore WEISSHORN for the cellular domain, count lost sends and
messages, grade the daily RSRP and RSRQ medians on the published
Quectel grid, and record D-031.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 10:48:34 +02:00

79 lines
5.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# `DAILY_SIGNAL_STATE` : niveau du signal 4G jour par jour
- **Statut** : prototype en place (2026-10-13). État seul, sans verdict ; pas encore de cas annotés par l'expert.
- **Script** : deuxième et troisième panneaux de `python3 src/cellular/all_analyses.py [CSV ou dossiers]` (défaut : `data/WEISSHORN/`), qui écrit `out/<STATION>_cellular.html` et l'ouvre.
- **Code** : `src/cellular/signal_state.py` (`run()`, `day_facts()`, `grade()`), bibliothèque standard uniquement, sans import du projet.
## Question posée
Chaque jour, le signal 4G reçu est-il excellent, bon, moyen ou en limite de cellule ?
- **Lien avec la question du domaine** : un signal faible ou brouillé met le lien en danger avant qu'il ne tombe. `DAILY_LINK_STATE` dit si les données arrivent ; celle-ci dit dans quelles conditions radio.
- **Deux mesures indépendantes** : le RSRP (force du signal) et le RSRQ (part du signal utile dans tout ce qui est reçu). Sur WEISSHORN, leur corrélation horaire est de −0,03 (`docs/cellular/domaine/point-de-depart.md`) : l'une ne remplace pas l'autre.
## Principe
On classe la médiane du jour de chaque mesure sur une grille publiée, et le jour prend la pire des deux classes. Seuils absolus, choisis par l'utilisateur plutôt que la comparaison au propre passé (D-031).
Calcul exact, pour chaque jour UTC d :
1. Valeurs horaires de `rsrp_dBm` et `rsrq_dB` non vides et finies (chaque heure est la moyenne de 4 instantanés).
2. `coverage` = min(heures mesurées en RSRP, en RSRQ) / 24. Si `coverage` < `MIN_COVERAGE` : `state` = `None` (UNKNOWN).
3. `rsrp_median_dbm`, `rsrq_median_db` = médianes du jour. La médiane sur 24 h écarte les décrochages de nuit du RSRP et le cycle quotidien du RSRQ.
4. Chaque médiane prend la première classe dont elle atteint le plancher : `EXCELLENT`, `GOOD`, `MID_CELL`, sinon `CELL_EDGE` → `rsrp_class`, `rsrq_class`.
5. `state` = la pire des deux classes.
Sortie (contrat commun) : un point par jour.
- `t` = dernière heure du jour présente dans les séries.
- `value` = `rsrp_median_dbm`, en dBm (`None` si UNKNOWN).
- `anomaly` = `None` : état seul, sans verdict. L'état est dans `facts.state`.
- `facts` = `state`, les deux médianes et leurs classes, `rsrp_min_dbm` (pour voir les décrochages de nuit), `coverage`.
## Constantes et sources
| Constante | Valeur | Source |
|---|---|---|
| `RSRP_FLOORS_DBM` | −80 / −90 / −100 | Grille « RF Quality » attribuée à Quectel (modem BG96) par [KORE Wireless](https://docs.korewireless.com/supersim/cellular-module-knowledgebase/how-to-determine-good-cellular-signal-strength), « a rough guide » ; même grille sur le [wiki Teltonika](https://wiki.teltonika-networks.com/view/RSRP_and_RSRQ). |
| `RSRQ_FLOORS_DB` | −10 / −15 / −20 | Même grille. |
| `MIN_COVERAGE` | 0,8 | Repris de `DAILY_BATTERY_STATE` : 20 heures mesurées sur 24. |
- **Ce que la grille n'est pas** : ni la norme 3GPP (qui définit la mesure, pas sa qualité), ni la doc du module de la station (NimbeLink NL-SW-LTE-TC4WWG, Telit LE910C4), qui n'en publie pas à notre connaissance. D'autres éditeurs placent les seuils 10 à 20 dB plus bas (ex. « Good » de −90 à −104 dBm).
- **`CELL_EDGE` en RSRQ est inatteignable** : le collecteur plafonne la mesure à −19,5 dB (code AT 0), au-dessus du plancher de −20 dB.
## Graphique
- **En haut, deux panneaux** (un par unité : pas de double axe, skill dataviz) : la médiane du jour du RSRP en dBm, puis celle du RSRQ en dB. Les planchers de la grille sont en pointillés, la classe de la mesure en marqueurs ; l'état du jour (la pire classe) est dans le survol.
- **Dessous** : les séries du modem.
## Résultats sur WEISSHORN (jeu de travail)
- 04/10 au 12/10 : `GOOD` les 9 jours. RSRP `EXCELLENT` (médianes de −71,5 à −66,6 dBm), RSRQ `GOOD` (médianes de −14,75 à −13,25 dB).
- Le RSRQ est la mesure qui décide, et il est à 0,25 dB du plancher de `GOOD` (−14,75 dB les 05, 06 et 07/10) : un jour à peine plus chargé passerait `MID_CELL`.
- Les décrochages de nuit (RSRP minimum de −98,25 dBm le 05 et le 07/10) n'atteignent pas la médiane.
- 03/10 et 13/10 : UNKNOWN (couverture de 0,71 et 0,33, jours coupés par l'export).
## Options écartées
| Option | Pourquoi écartée |
|---|---|
| Comparer la station à son propre passé | Choix de l'utilisateur pour des seuils absolus (D-031) ; aveugle les premiers jours, et l'export ne fait que 10 jours. |
| Le minimum du jour | Déclenché par les décrochages de nuit, 6 nuits sur 10 sur WEISSHORN. |
| RSSI et BER | RSSI au plafond 220 heures sur 241 ; BER redondant avec le RSRQ (r = −0,87). |
| Un seul panneau à deux axes | Deux unités : le skill dataviz l'interdit. |
## Limites connues
1. **Grille d'un autre modem** : publiée pour le Quectel BG96, présentée comme indicative. À confirmer par l'expert ou par le fabricant du module.
2. **Le RSRQ dépend de la charge de la cellule** : son cycle quotidien (−9 dB la nuit, −16 dB le jour sur WEISSHORN) peut faire basculer la classe sans changement à la station.
3. **Moyennes horaires en dB**, puis médiane : un décrochage bref n'est pas vu.
4. **Changement de cellule non observable** : une marche de ~10 dB du RSRP peut être un changement de cellule, pas une dégradation.
5. **Aucun cas annoté par l'expert.**
## Pistes
- Quand l'historique sera long : comparer la médiane du jour au passé de la station, pour voir une dégradation lente qui reste dans la même classe.
- Une marge autour des planchers, si la classe oscille d'un jour à l'autre.
## Historique
- **2026-10-13** : création (D-031).