Files
aimsight-tools/README.md
T

1.8 KiB

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:

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.