Compare commits

..
4 Commits
3 changed files with 11 additions and 8 deletions

No files matched your search

+6 -3
View File
@@ -1,8 +1,8 @@
# CLAUDE.md
tools: the reading harness of the AIMsight agents (`README.md`), and nothing else. The user guide is `GUIDE.md`; a new tool or a new option goes into it in the same change. `DATA.md` (what the data are) is maintained by hand by the user; `GUIDE.md` is the tool-builder's.
tools: the reading harness of the AIMsight agents (`README.md`), and nothing else. The user guide is `GUIDE.md`; a new tool or a new option goes into it in the same change. `DATA.md` (what the data are) is maintained by hand by the user; `GUIDE.md` is the upgrader's (`agents` repository, run by Optimizer's `optimize` skill).
- **Checking a change**: rerun the touched tool from a calling repository (Diagnostic-App: `python3 tools/scripts/<tool>.py data/<STATION> --start … --end …`), and the commands of the guide that use it; `python3 scripts/quality.py --self-test`.
- **Checking a change**: rerun the touched tool from a calling repository (aimsight-app: `python3 tools/scripts/<tool>.py data/<STATION> --start … --end …`), and the commands of the guide that use it; `python3 tools/scripts/quality.py --self-test` (from the calling repository).
Rules:
- A tool returns values: no threshold, no category, no "anomaly", no "normal"; the analyst judges.
@@ -11,5 +11,8 @@ Rules:
- Standard library; matplotlib, through the caller's `.venv/bin/python`, for the figures only.
- Never a value from `metrics/` that is an identifier (`SIM_CCID`, `ip*`); read-only on `data/`; never read `.env`.
- Break nothing: existing options and outputs stay, the analyses' reports cite commands that must keep working.
- `scripts/data.py` is the common reader of the app and the tools: touch it only to fix a reading error. The app passes these measurements to the detectors (the events of the Data page), which otherwise read with `detectors/scripts/data.py` (benchmark, Optimizer): a reading fix here is carried over there, otherwise the page and the benchmark diverge silently.
- A change to improve the tools touches `scripts/` and `GUIDE.md` only; `README.md`, `CLAUDE.md` and `DATA.md` (the user's) are not part of it.
- Remove nothing: no tool, no option, no output, no sentence of the guide; a tool that did not help on one range may help on another, and a single analysis is not enough to clean the list. Optimise or add.
- The simplest first: a sentence of the guide or a better default; otherwise an option of an existing tool; a new tool as a last resort. A new script has a docstring at the top, like the others, and enters the table of `GUIDE.md` in the same change.
- `scripts/data.py` is the common reader of the app and the tools: touch it only to fix a reading error. The app passes these measurements to the detectors (the events of the Data page), which otherwise read with `detectors/scripts/data.py` (benchmark, Optimizer): a reading fix here is carried over there, otherwise the page and the benchmark diverge silently. A change to `data.py` is said at the top of the change's report; the same fix in `detectors/scripts/data.py` is left to the user, named in that report.
- Every time is in UTC. Commits by path, never `git add -A`. Language: English.
+1 -1
View File
@@ -1,6 +1,6 @@
# Reading the data
The guide to the reading harness: followed by the analyst; improved by the tool-builder (agents repository), the only one that writes here.
The guide to the reading harness: followed by the analyst; improved by the upgrader (agents repository), run by Optimizer's `optimize` skill, the only one that writes here.
A camera tracks targets (reflectors) fixed on a structure; its own movement is compensated thanks to reference targets, assumed fixed. This movement, the **camera pose** (`pan`, `tilt`, `rotation` in degrees, `scale`, `sigma0` of the registration, in `camera/`), is read before the sensors: it explains a large part of what moves on the curves (D-073). This guide says how to read a station's data: what the curves and the images show, moment by moment. It does not say what they mean: family, known event, hypothesis and verdict are the business of whoever calls you.
+4 -4
View File
@@ -4,12 +4,12 @@ The reading harness: the methods given to the agent to make sense of the data of
- `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.
- `scripts/data.py`: the common reader of the data (also that of the aimsight-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:
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
@@ -20,6 +20,6 @@ Without `--out`, the figures go to `out/diagnostic/` of the current folder. Stan
## 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.
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 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`.
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`.