# tools 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/`: the tools, one script each; `GUIDE.md`: which tool for which question, and how to read what it returns. The agent reads it first. - `DATA.md`: the files of a station and the meaning of their columns, maintained by hand; the agent reads it with the guide. - `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). ## Using it 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/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 ``` Without `--out`, the figures go to `out/diagnostic/` of the current folder. Standard library; matplotlib (through the caller's `.venv`) for the figures only. ## Who changes it 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. 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`.