Documentazione aggiornata: assunzioni A17/A25, limiti, algoritmi, test, output e figura

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

docs/uso.md

@@ -22,21 +22,21 @@ t_ms,T_C,dT_C
 301,22.63,0.03
 ```
 
-I CSV di prova si generano con il repository fratello `../gen_data` (modello: `../gen_data/docs/SPEC.md`). I test di integrazione usano i seed 1–3:
+I CSV di prova si generano con il repository fratello `../gen_data` (modello: `../gen_data/docs/SPEC.md`). A ogni seed il generatore sorteggia numero dei gradini
+(1–3), costante di tempo, rumore e disturbi: ogni file ha una struttura diversa.
 
 ```bash
 mkdir -p input
-for s in 1 2 3; do
-  (cd ../gen_data && .venv/bin/python genera.py config.toml --seed $s -o ../EquationMiner/input/gen_$s.csv)
-done
+(cd ../gen_data && .venv/bin/python genera.py config.toml --seed 7 -o ../EquationMiner/input/gen_7.csv)
 ```
+I test **non** richiedono questi file: generano i dati da soli ([test.md](test.md)).
 
 ## 3. Comandi
 
 ```bash
-fitseg domini input/gen_1.csv      # passo 1: come verrebbero suddivisi i dati (tabella, domini.png, domini.toml), nessun fit
-fitseg analizza input/gen_1.csv    # tutti i passi: domini, equazioni, sovrapposizione, report
-fitseg analizza input/gen_1.csv --domini output/gen_1/01_domini/domini.toml   # con i domini corretti a mano
+fitseg domini input/gen_7.csv      # passo 1: come verrebbero suddivisi i dati (tabella, domini.png, domini.toml), nessun fit
+fitseg analizza input/gen_7.csv    # tutti i passi: domini, equazioni, sovrapposizione, report
+fitseg analizza input/gen_7.csv --domini output/gen_7/01_domini/domini.toml   # con i domini corretti a mano
 ```
 
 | Opzione | Dove | Significato |
@@ -71,6 +71,19 @@ con supporto matematico (formule in LaTeX).
 
 Gli errori sono stampati su stderr in italiano come `Errore: …`.
 
-## 6. Sviluppo
+## 6. Pulizia dei dati
+
+```bash
+./pulisci.sh                  # svuota output/ e cancella input/*.csv, chiede conferma
+./pulisci.sh -n               # dry-run: mostra cosa cancellerebbe, senza cancellare
+./pulisci.sh --solo-output    # pulisce solo output/, lascia input/ com'è
+./pulisci.sh -y               # tutto, senza chiedere conferma
+```
+Cancella: il contenuto di `output/` (cartella di `[output] cartella_output`: risultati che si rifanno rilanciando `fitseg analizza`) e i file `*.csv` in `input/`
+(i dati grezzi: **non** si rigenerano da soli, si rifanno con `../gen_data`, §2, per questo chiede conferma salvo `-y`). Le cartelle e i loro `.gitkeep`
+restano; i file di `input/` che non sono `.csv` non si toccano. Rifiuta percorsi di output assoluti o con `..`. Codici di uscita: 0 ok (o niente da pulire), 1 annullato o
+percorso non sicuro, 2 opzione sconosciuta.
+
+## 7. Sviluppo
 
 Test e controllo dello stile: [test.md](test.md). Mappa del codice e come aggiungere un modello: [moduli.md](moduli.md).