Documentazione: uso con ambiente .venv creato con uv

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

README.md

@@ -2,9 +2,17 @@
 
 Genera un CSV con la temperatura `T` di un sensore IR e la differenza `ΔT = T − T_amb`, con rumore, quantizzazione e jitter dei tempi simili a un sensore reale. `T` parte dalla temperatura ambiente, sale con i gradini di riscaldamento e ridiscende fino a `T_amb`.
 
-## Requisiti
+## Requisiti e ambiente
 
-[uv](https://docs.astral.sh/uv/). Gli script dichiarano le loro dipendenze (Python ≥ 3.11, `numpy`, `matplotlib` per il grafico): al primo avvio uv crea da solo l'ambiente virtuale e, se serve, scarica Python. Non serve installare altro.
+Python ≥ 3.11 con `numpy` e `matplotlib` (quest'ultimo solo per il grafico), in un ambiente virtuale `.venv` nella cartella del progetto. Lo si crea con [uv](https://docs.astral.sh/uv/), più veloce di `venv` + `pip`:
+
+```bash
+uv venv .venv
+uv pip install numpy matplotlib
+source .venv/bin/activate        # poi si usa `python ...`; senza attivare: `.venv/bin/python ...`
+```
+
+`.venv/` è ignorato da git. Con `venv` classico: `python -m venv .venv && .venv/bin/pip install numpy matplotlib`.
 
 ### Installare uv
 
@@ -18,11 +26,13 @@ Apri un nuovo terminale e verifica con `uv --version`. Altre opzioni (Homebrew,
 
 ## Uso
 
+Con l'ambiente `.venv` attivo (altrimenti sostituisci `python` con `.venv/bin/python`):
+
 ```bash
-uv run genera.py config.toml                      # scrive output/gen_<seed>.csv, seed casuale
-uv run genera.py config.toml --seed 42            # riproducibile: output/gen_42.csv
-uv run genera.py config.toml -o dati/prova.csv    # percorso a scelta (cartelle create se mancano)
-uv run genera.py config.toml -o - > out.csv       # su stdout
+python genera.py config.toml                      # scrive output/gen_<seed>.csv, seed casuale
+python genera.py config.toml --seed 42            # riproducibile: output/gen_42.csv
+python genera.py config.toml -o dati/prova.csv    # percorso a scelta (cartelle create se mancano)
+python genera.py config.toml -o - > out.csv       # su stdout
 ```
 
 | Opzione | Descrizione |
@@ -36,12 +46,12 @@ Stesso seed e stessa configurazione danno sempre lo stesso file. La cartella `ou
 ## Grafico
 
 ```bash
-uv run grafico.py                          # apre il grafico dell'ultimo CSV in output/
-uv run grafico.py output/gen_42.csv        # un CSV preciso
-uv run grafico.py -o grafico.png           # salva l'immagine (png, pdf, svg) invece di aprire la finestra
+python grafico.py                          # apre il grafico dell'ultimo CSV in output/
+python grafico.py output/gen_42.csv        # un CSV preciso
+python grafico.py -o grafico.png           # salva l'immagine (png, pdf, svg) invece di aprire la finestra
 ```
 
-Mostra `T` e `ΔT` in funzione del tempo. `grafico.py` ha le sue dipendenze (`numpy`, `matplotlib`), gestite da uv come per `genera.py`; senza schermo usa `-o`.
+Mostra `T` e `ΔT` in funzione del tempo. `grafico.py` ha le sue dipendenze (`numpy`, `matplotlib`), vedi sopra; senza schermo usa `-o`.
 
 ## Pulizia