From dfbcc1d21570ff1a67c48c9e3b569ca01724baf1 Mon Sep 17 00:00:00 2001 From: Davide Grilli Date: Thu, 14 May 2026 11:03:46 +0200 Subject: [PATCH] README: documenta requisiti di data.csv MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Aggiunge sezione con formato (CSV, virgola, UTF-8), nomi esatti delle colonne obbligatorie, unità di misura e requisito sulla copertura temporale. Co-Authored-By: Claude Sonnet 4.6 --- README.md | 29 +++++++++++++++++++++++------ 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index c8c6fa0..b0133f4 100644 --- a/README.md +++ b/README.md @@ -88,15 +88,32 @@ Il PDF viene generato direttamente da Python tramite `reportlab` (nessuna dipend --- -## Dati +## Requisiti di data.csv -`data.csv` — colonne utilizzate: +### Formato -| Colonna | Descrizione | +| Proprietà | Valore richiesto | | --- | --- | -| `time since start [ms]` | tempo dall'inizio (convertito in secondi negli script) | -| `temp_obj IR [C]` | temperatura della scatola (target del fit) | -| `temp_amb IR [C]` | temperatura ambiente (usata per calcolare T∞) | +| Formato | CSV | +| Separatore | `,` (virgola) | +| Encoding | UTF-8 | +| Prima riga | intestazione (header) | + +### Colonne obbligatorie + +I nomi delle colonne devono corrispondere **esattamente** (spazi e maiuscole inclusi): + +| Colonna | Unità | Descrizione | +| --- | --- | --- | +| `time since start [ms]` | ms | Tempo dall'inizio acquisizione — convertito in secondi (`/ 1000`) da tutti gli script | +| `temp_obj IR [C]` | °C | Temperatura dell'oggetto misurato (target del fit) | +| `temp_amb IR [C]` | °C | Temperatura ambiente (usata per calcolare T∞) | + +Le colonne aggiuntive presenti nel file vengono ignorate. + +### Copertura temporale + +Il file deve contenere campioni nei range temporali usati da ciascuno script. I parametri `T0` e `T_END` in ogni `appX.py` devono ricadere all'interno dei valori di `time since start [ms]` presenti nel CSV (convertiti in secondi). ## Modello di fitting