English: tools renamed and translated (same numbers as before), options and printed names in English; the guide translated

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-16 12:40:03 +01:00
1 parent 67c88625c5
commit f28bd19e04
25 files changed
+2764 -2762

No files matched your search

+12 -12
View File
@@ -1,24 +1,24 @@
# tools
Le harnais de lecture : les méthodes données à l'agent pour appréhender les données d'une station AIMsight. Chaque outil répond à une question que se pose l'analyste et rend des valeurs, des plages datées, une figure ou des vignettes ; il montre, il ne juge pas.
The reading harness: the methods given to the agent to make sense of the data of an AIMsight station. Each tool answers a question the analyst asks and returns values, dated ranges, a figure or thumbnails; it shows, it does not judge.
- `scripts/` : les outils, un script chacun ; `GUIDE.md` : quel outil pour quelle question, et comment lire ce qu'il rend. L'agent le lit en premier.
- `scripts/donnees.py` : la lecture commune des données (aussi celle de l'app Diagnostic-App, qui passe ces mesures aux détecteurs) ; les détecteurs gardent la leur (`detectors/scripts/data.py`), pour rester autonomes : une correction de lecture dans l'une se reporte dans l'autre.
- Les outils : `inventaire`, `resume`, `plages`, `jours`, `ensemble`, `metriques`, `qualite`, `stations`, `graphique`, `vignettes`, `gif` (le détail dans le guide).
- `scripts/`: the tools, one script each; `GUIDE.md`: which tool for which question, and how to read what it returns. The agent reads it first.
- `scripts/data.py`: the common reader of the data (also that of the Diagnostic-App app, which passes these measurements to the detectors); the detectors keep their own (`detectors/scripts/data.py`), to stay autonomous: a reading fix in one is carried to the other.
- The tools: `inventory`, `summary`, `ranges`, `days`, `overview`, `metrics`, `quality`, `stations`, `plot`, `thumbnails`, `gif` (details in the guide).
## S'en servir
## Using it
Le dépôt appelant y pointe par un lien `tools -> ~/tools` (ignoré par git), à côté de ses liens `data/` et `labeling/`, et lance les outils depuis sa racine :
The calling repository points to it through a link `tools -> ~/tools` (ignored by git), next to its `data/` and `labeling/` links, and runs the tools from its root:
```bash
python3 tools/scripts/inventaire.py data/NORDEND --debut 2026-11-05T00:00Z --fin 2026-11-06T00:00Z
.venv/bin/python tools/scripts/graphique.py data/NORDEND --debut 2026-11-05T00:00Z --fin 2026-11-06T00:00Z --sortie out/diagnostic
python3 tools/scripts/inventory.py data/NORDEND --start 2026-11-05T00:00Z --end 2026-11-06T00:00Z
.venv/bin/python tools/scripts/plot.py data/NORDEND --start 2026-11-05T00:00Z --end 2026-11-06T00:00Z --out out/diagnostic
```
Sans `--sortie`, les figures vont dans `out/diagnostic/` du dossier courant. Bibliothèque standard ; matplotlib (par le `.venv` de l'appelant) pour les figures seulement.
Without `--out`, the figures go to `out/diagnostic/` of the current folder. Standard library; matplotlib (through the caller's `.venv`) for the figures only.
## Qui le fait évoluer
## Who changes it
Seul le `tool-builder` (dépôt `agents`) y écrit, après une analyse : il fait entrer les scripts utiles de l'analyste dans les outils, il optimise ou ajoute, il ne retire rien.
Only the `tool-builder` (`agents` repository) writes there, after an analysis: it brings the analyst's useful scripts into the tools, it optimizes or adds, it removes nothing.
Copié de Diagnostic-App (`agent-tools/` et le skill `lire-les-donnees`, commit dd6f1bf) le 2026-11-16. L'architecture des dépôts : `~/Diagnostic-App/docs/architecture.drawio`.
Copied from Diagnostic-App (`agent-tools/` and the `lire-les-donnees` skill, commit dd6f1bf) on 2026-11-16. The architecture of the repositories: `~/Diagnostic-App/docs/architecture.drawio`.