Documentazione: uso con ambiente .venv creato con uv

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-10-29 09:08:25 +01:00
1 parent 55085ac3ef
commit 4592f5f87b
4 files changed
+27 -17

No files matched your search

+1 -1
View File
@@ -31,7 +31,7 @@ Formato dell'uscita: `t_ms,T_C,dT_C` (`t_ms` intero, gli altri a due decimali).
## Ambiente
- Gli script girano con [uv](https://docs.astral.sh/uv/): le dipendenze (`numpy`, più `matplotlib` per il grafico) sono dichiarate nello script (PEP 723) e uv crea da solo l'ambiente virtuale.
- Gli script girano in un ambiente `.venv` nel progetto (creato con [uv](https://docs.astral.sh/uv/): `numpy`, più `matplotlib` per il grafico). Le dipendenze sono dichiarate anche nello script (PEP 723), quindi `uv run` funziona comunque.
- La cartella `output/` è ignorata da git.
## Riferimento dati reali
+5 -5
View File
@@ -36,9 +36,9 @@ Nessun valore è scritto nello script: chiave mancante ⇒ errore.
Poi arrotondamento a `passo_T_c`.
5. **Ambiente e ΔT**: `amb_i = round_{amb_passo}( amb_inf + amb_A·exp(−t/τ_amb) + N(0, amb_sigma²) )`; `dT_i = round_{passo}( T_i − amb_i )`.
## 4. Uso con uv (un solo file, nessun progetto)
## 4. Uso (script unico, ambiente `.venv`)
`genera.py` con dipendenza dichiarata in testa (PEP 723):
`genera.py` con dipendenza dichiarata in testa (PEP 723, usata anche da `uv run`); ambiente `.venv` creato con `uv venv` e `uv pip install numpy`:
```python
# /// script
# requires-python = ">=3.11"
@@ -46,9 +46,9 @@ Nessun valore è scritto nello script: chiave mancante ⇒ errore.
# ///
```
```bash
uv run genera.py config.toml --seed 42 # riproducibile -> output/gen_42.csv
uv run genera.py config.toml -o out.csv # percorso a scelta, seed casuale (stampato su stderr)
uv run genera.py config.toml -o - > out.csv # stdout
python genera.py config.toml --seed 42 # riproducibile -> output/gen_42.csv
python genera.py config.toml -o out.csv # percorso a scelta, seed casuale (stampato su stderr)
python genera.py config.toml -o - > out.csv # stdout
```
Opzioni: `config` (posizionale), `-o/--output` (default `output/gen_<seed>.csv`, cartella creata se manca; `-` = stdout), `--seed` (default: casuale, stampato su stderr).
Uscita con errore (exit 1) e messaggio in italiano se manca una chiave, se `t_impulsi_s` e `dT_impulsi_c` hanno lunghezze diverse