Aggiunge specifica del generatore, configurazione d'esempio e CLAUDE.md

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-10-29 08:46:31 +01:00
commit 443f7bac66
3 files changed
+123

No files matched your search

+19
View File
@@ -0,0 +1,19 @@
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Stato
`genera.py` non esiste ancora: il repository contiene solo specifica, configurazione e dati reali. Implementalo seguendo [docs/SPEC.md](docs/SPEC.md), unica fonte di verità su output, modello, CLI (comandi `uv run`), errori e controlli di accettazione. Leggila per intero prima di scrivere codice. Documentazione, commenti e messaggi di errore sono in italiano.
## File
- [config.toml](config.toml): esempio e unica fonte dei valori numerici. Le unità sono nei suffissi delle chiavi (`_s`, `_ms`, `_c`, `_hz`).
- [dati.csv](dati.csv): registrazione reale del sensore IR (`temp_amb IR [C]`, `temp_obj IR [C]`, più roll/jolt). Riferimento per ricalibrare `sigma_c`, `wander_*`, `amb_*`; non è un output del generatore e ha formato diverso.
## Vincoli facili da perdere
- `ΔT` = T − ambiente, calcolato **dopo** rumore e quantizzazione di entrambi i canali, mai dalla T vera.
- Nessun valore numerico nello script: chiave mancante ⇒ exit 1.
- Un solo `numpy.random.Generator` seminato da `--seed`, così stesso seed + stessa config ⇒ file identico.
- Verifica l'implementazione con i controlli di §5 di SPEC.md sulla config d'esempio.