davideandClaude Sonnet 5.5
f28bddc5a2
- docs/SPEC.md sostituito da un file per argomento (indice in docs/README.md) - assunzioni A1-A24 con dove nel codice e cosa succede se false - formule in LaTeX corrette (nessuno spazio prima del dollaro di chiusura), simboli e chiavi in tabella - diagrammi Mermaid per il flusso degli algoritmi e le dipendenze dei moduli - figura dei domini sul seed 1 (docs/img/domini_esempio.png) - README ridotto a indice con avvio rapido; CLAUDE.md e docstring allineati Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
fitseg
Legge un CSV t_ms,T_C,dT_C (temperatura di un sensore IR che si scalda a gradini e si raffredda), lo divide in domini (riposo, riscaldamento, raffreddamento) e
trova per ognuno l'equazione che lo approssima meglio. Produce, per ogni CSV, i grafici della suddivisione, la sovrapposizione dei dati grezzi con le equazioni trovate
e un report in Markdown con formule in LaTeX.
Documentazione
Tutto è spiegato in docs/: assunzioni, algoritmi, moduli, configurazione, output, test, limiti.
| Se vuoi… | Vai a |
|---|---|
| capire cosa fa e vedere un esempio | docs/panoramica.md |
| installare e lanciare i comandi | docs/uso.md |
| sapere cosa si assume e quando non vale | docs/assunzioni.md |
| capire come si ottengono le equazioni | docs/algoritmi.md |
| orientarti nel codice | docs/moduli.md |
cambiare un valore (config.toml) |
docs/configurazione.md |
| leggere i file e i grafici prodotti | docs/output.md |
| eseguire i test | docs/test.md |
| conoscere i limiti | docs/limiti.md |
Avvio rapido
uv venv .venv && uv pip install -e ".[dev]" # installazione: docs/uso.md §1
.venv/bin/fitseg domini input/gen_1.csv # passo 1: come verrebbero suddivisi i dati
.venv/bin/fitseg analizza input/gen_1.csv # tutti i passi → output/gen_1/{01_domini,02_sovrapposizione,03_report}
.venv/bin/pytest # test: docs/test.md
I CSV da analizzare vanno in input/ (dati di prova da ../gen_data: docs/uso.md §2). Il report è output/<csv>/03_report/report.md.