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:
1 parent
67c88625c5
commit
f28bd19e04
25 files changed
+2764
-2762
No files matched your search
@@ -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`.
|
||||
Reference in new issue
Block a user