26 lines
1.9 KiB
Markdown
26 lines
1.9 KiB
Markdown
# 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 one reader of the data, shared by the aimsight-app app, the tools and the detectors (which import it); a change to it changes the detectors' benchmark (`python3 detectors/bench/regression.py --labels labeling/auto --data data`, from aimsight-app). `scripts/common.py`: the helpers the tools share.
|
|
- 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 -> ~/aimsight-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 `upgrader` (`agents` repository) writes there, run by Optimizer's `optimize` skill after an analysis: it brings the analyst's useful scripts into the tools, it optimizes or adds, it removes nothing.
|
|
|
|
Copied from aimsight-app (`agent-tools/` and the `lire-les-donnees` skill, commit dd6f1bf) on 2026-11-16. The architecture of the repositories: `~/aimsight-app/docs/architecture.drawio`.
|