Guida alla libreria di tabelle

Come conservare curve e matrici di dati (curve di una pompa, proprietà di un fluido…) e usarle nelle equazioni dei componenti.

Molte grandezze non hanno una formula, ma una tabella di punti: il calore specifico dell'acqua in funzione della temperatura, la curva portata-prevalenza di una pompa. La libreria le tiene in un posto solo, salvate sul server, e i componenti le richiamano per nome: i dati esistono una volta sola, e se li correggi cambiano per tutti i componenti che li usano.

• 1. La schermata
• 2. Curva o matrice
• 3. Scrivere i dati
• 4. Unità e anteprima
• 5. Importare da file
• 6. Estrarre da foto, PDF o testo
• 7. Salvare e usare la tabella
• 8. Errori frequenti

1. La schermata

• A sinistra l'elenco delle tabelle, con tipo (curva o matrice) e numero di punti. Cerca per nome o descrizione, poi apri una voce con clic o Invio. Il pulsante Libreria nasconde o riapre il pannello; il separatore ne regola la larghezza anche con le frecce della tastiera.
• A destra l'editor diviso in definizione della tabella e dati. Su desktop i punti e l'anteprima del grafico sono affiancati; sulle finestre strette il grafico scende sotto i dati, con scorrimento orizzontale se serve a leggere gli assi.
• Nuova tabella in alto crea una bozza vuota. Non è salvata finché non premi Salva su server nella barra principale. La riga sotto indica se è una bozza, se ci sono modifiche da salvare o se il salvataggio è riuscito.
• Vai a porta a Componenti, Processo e Calcolatrice. Se cambi tabella con modifiche non salvate, viene chiesto se scartarle. Sulle finestre strette la libreria parte chiusa.

2. Curva o matrice

Tra un punto e l'altro il motore interpola linearmente; fuori dall'intervallo dei dati estrapola in linea retta, quindi controlla di restare nel campo coperto. Nelle matrici anche il parametro p si interpola tra le curve.

Limiti: una curva ha da 2 a 1000 punti, con valori di x tutti diversi; una matrice ha da 2 a 100 curve con valori di p diversi.

3. Scrivere i dati

Nel campo Dati, un punto per riga, con valori separati da virgola, punto e virgola, tab o spazi e il punto decimale. Le righe che iniziano con # sono commenti. Puoi incollare colonne copiate da un foglio di calcolo.

Curva (calore specifico dell'acqua in funzione della temperatura):

# x, y
0, 4.217
20, 4.182
40, 4.179
60, 4.185
80, 4.197
100, 4.216

Matrice (due curve, per p = 1 e p = 5):

# p, x, y
1, 0, 10
1, 100, 12
5, 0, 20
5, 100, 25

Sotto i dati compaiono subito gli eventuali errori (righe non numeriche, x ripetute, troppi punti) e l'anteprima del grafico, dove si vede a occhio se un punto è fuori posto.

4. Unità e anteprima

• Unità x e Unità y (e Unità p per le matrici): un'etichetta, come °C o kJ/(kg K). Il campo propone un elenco di unità comuni, ma puoi scrivere ciò che vuoi.
• Le unità sono solo etichette: compaiono sugli assi dell'anteprima e ti ricordano in che unità sono i dati, ma il motore non le controlla né converte. Se la curva è in °C e l'equazione la chiama con kelvin, i numeri restano quelli.
• La descrizione è il posto giusto per la fonte e le condizioni (per esempio «a pressione atmosferica»).

5. Importare da file

Importa da file legge un file .csv, .txt, .tsv o .dat e lo mette nel campo Dati. Il file viene letto nel tuo browser: ciò che salvi finisce nel database solo quando premi Salva. Il file deve già avere il formato del paragrafo 3.

6. Estrarre da foto, PDF o testo

Se i dati sono su una foto, un PDF o un testo in formato libero (con intestazioni, punto e virgola, virgola decimale…), il pannello Estrai da foto, PDF o testo, con il comando Scegli documento, li legge per te e li scrive nel campo Dati. Non è disponibile nella demo.

1. Scegli, se vuoi, che cosa cercare: automatico, una curva o una matrice.
2. Se serve, scrivi istruzioni per l'AI («i valori sono in °F e °C: usa la colonna in °C», «ignora le righe di ritorno», «p è la pressione indicata in testata di ogni blocco»).
3. Scegli il file (fino a 8 MB). L'estrazione richiede da pochi secondi a circa un minuto.
4. Accanto ai dati compare l'originale: confrontali riga per riga. Con Rielabora con le istruzioni rileggi lo stesso file dopo aver cambiato le istruzioni.
5. Controlla nome, unità e descrizione (l'estrazione li compila se li trova) e poi salva.

• I testi con righe già numeriche e regolari si leggono senza modello, in modo esatto. Gli altri testi, le foto e i PDF passano da un modello di intelligenza artificiale.
• Compaiono avvisi quando qualcosa non torna: righe non numeriche scartate, x ripetute o non ordinate, punti anomali. Se i valori sono stimati da un grafico lo dice.
• Se chiedi una conversione di unità la fa il modello: controlla i numeri.

7. Salvare e usare la tabella

• Salva su server memorizza la tabella sul server, nel tuo archivio.
• Conflitto di salvataggio: un'altra scheda o un altro utente ha modificato la tabella. La bozza resta aperta. Copia dati, descrizione e unità in un file prima di riaprire la tabella dalla libreria, poi confronta le modifiche e riportale nella copia aggiornata.
• Nell'editor di un componente, scheda Tabelle, + Tabella / matrice sceglie una tabella della libreria e le dà un nome istanza, con cui la chiami nelle equazioni: cp(T) per una curva, h(p, x) per una matrice. Vedi la guida dei componenti.
• Sotto l'editor vedi da quali componenti è usata. Un componente conta come utilizzatore solo dopo Salva su server nella pagina Componenti.
• Una tabella usata da qualche componente non si può eliminare: l'elenco dei componenti compare nel messaggio.
• Modificare i dati vale subito per tutti i componenti che la usano: se cambi la curva di una pompa, cambia in ogni processo che la contiene.

8. Errori frequenti

• «Il nome è obbligatorio»: senza nome non si salva.
• Virgola decimale: i numeri vogliono il punto (4.18, non 4,18); la virgola separa le colonne. Se hai una virgola decimale nel file, usa l'estrazione da testo o correggi a mano.
• Punti con la stessa x in una curva: ogni x deve comparire una volta.
• Troppo pochi punti: una curva ne vuole almeno due, una matrice almeno due curve.
• Fuori intervallo: oltre gli estremi il valore è estrapolato in linea retta e può non avere senso fisico.
• Unità non coerenti tra tabella ed equazione: sono solo etichette, la conversione la fai tu.
• Dati estratti da foto non verificati: un numero letto male altera tutti i calcoli che usano la tabella.

Vedi anche Verifica dei risultati.