Guida all'editor di componenti

Come descrivere un componente di impianto (una pompa, una valvola, uno scambiatore…) con terminali, variabili ed equazioni, provarlo da solo e riusarlo nei processi.

Un componente è un modello riutilizzabile: ha dei terminali (i punti dove si collega ad altri componenti), delle variabili e delle equazioni che le legano. Nella pagina Processo lo metti più volte e lo colleghi con linee; qui lo costruisci e lo provi da solo.

Percorso guidato accompagna nella creazione di un componente, nel suo salvataggio e nel collegamento di due istanze su un nuovo processo. Le azioni di esempio sono disponibili solo nella demo privata. Il modello di segnale dimezza 10 V in 5 V e poi in 2,5 V; i componenti già aperti restano nelle loro schede. Avvia il percorso.

Controlla unità verifica le dimensioni delle equazioni dichiarate e, nel processo, mostra anche gli avvisi sui collegamenti. I numeri letterali e i parametri fissi senza unità sono considerati adimensionali. Le scale diverse richiedono conversioni esplicite: il motore non converte. Unità mancanti e costrutti non supportati lasciano un controllo parziale, indicato nel riepilogo. Gli avvisi non bloccano il calcolo e non certificano la correttezza fisica. Il report del processo conserva il riepilogo del controllo.

Le modifiche hanno una copia locale separata per account, che resta in questo browser anche quando cambi account. Il salvataggio sul server e l'esportazione JSON permettono di conservare il lavoro anche su altri dispositivi. Se compare l'avviso di una copia della versione precedente, questa è conservata ma non aperta perché non ha un proprietario verificabile: rivolgiti all'assistenza per il recupero.

1. La schermata

I componenti aperti sono nella riga sotto i comandi, e a destra c'è l'indicatore di salvataggio, uguale in Componenti, Tabelle e Processo: Salvato, Modifiche da salvare, Salvataggio… oppure Errore: non salvato. Qui il salvataggio sul server è manuale (Salva su server). Le schede dei componenti si selezionano anche da tastiera.

Usa Disegno e proprietà e Modello per mostrare o nascondere i pannelli. Trascina il separatore per cambiarne la larghezza; da tastiera, metti a fuoco il separatore e usa le frecce, Home o Fine. Invio richiude il pannello. Sulle finestre sotto 1000 px il pannello del modello parte chiuso e si riapre con il suo pulsante. Queste impostazioni valgono solo nella pagina aperta e non modificano il componente.

Il disegno (rettangoli, ellissi, linee, testi) serve solo a riconoscere il componente nel processo: il calcolo dipende soltanto da terminali, variabili ed equazioni.

2. Costruire un componente, passo per passo

  1. Dai un nome al componente (a sinistra): lettera iniziale, poi lettere, cifre o _, al massimo 64 caratteri. Vale per tutti i nomi: componenti, terminali, variabili.
  2. Disegna una forma riconoscibile con Rettangolo, Ellisse, Linea e Testo (facoltativo).
  3. Aggiungi i terminali: strumento Terminale e clic sulla tavola, oppure + Terminale nella scheda Terminali.
  4. Dichiara le variabili: globali del componente (per esempio un coefficiente) e locali di ogni terminale (per esempio pressione e portata che passano da lì).
  5. Scrivi le equazioni che le legano, una per riga.
  6. Premi Esegui per provarlo da solo, poi Salva su server.

Esempio minimo, una valvola con portata proporzionale alla pressione, q = k·p:

in.q = k * in.p

Con Esegui il motore trova q = 6: è l'unica incognita (p e k sono costanti) e c'è una equazione.

3. Terminali

Un terminale è un punto di collegamento: nel processo trascini da un terminale all'altro per unire due componenti con una linea. Le variabili del terminale sono quelle che la linea trasporta (pressione, portata, temperatura…).

4. Variabili

La scheda Variabili ha due parti:

Per ogni variabile si indicano:

Regola base: servono tante equazioni quante incognite. Le costanti non contano come incognite; ogni espressione scritta come valore conta come una equazione in più.

5. Equazioni

Nella scheda Equazioni scrivi una equazione per riga, nella forma sinistra = destra. Le righe che iniziano con # sono commenti.

Per i modelli lunghi premi ⤢ Espandi, sopra il riquadro: le equazioni si aprono in una finestra grande al centro, con il conteggio delle equazioni e il tasto Tab che inserisce due spazi. Le modifiche valgono subito; Chiudi (o Esc) torna alla pagina.

ScritturaSignificato
V1, C1.V1variabile globale V1 del componente C1
T1.p, C1.T1.pvariabile p del terminale T1
cp(x)curva di una tabella (scheda Tabelle)
h(p, x)matrice di una tabella

Le equazioni hanno la sintassi del motore, che non è Python: operatori + - * / ^, funzioni (sqrt, exp, log, sin, abs, integral…), confronti e and or not, esponenti negativi tra parentesi (2^(-1)). La descrizione completa, con esempi da provare, è nella guida della calcolatrice.

Esempi di equazioni di un componente:

# perdita di carico quadratica
in.p - out.p = k * in.q^2
# bilancio di portata
in.q = out.q
# curva di una pompa data per punti (tabella "pompa")
out.p - in.p = pompa(in.q)

6. Tabelle e matrici

Per le curve misurate o di catalogo (curva di una pompa, proprietà di un fluido) la scheda Tabelle collega al componente una tabella della libreria:

7. Esegui

Esegui risolve il componente da solo, con i valori che hai impostato: serve a controllare che le equazioni siano coerenti prima di usarlo in un processo.

8. Salvare, esportare, usare nel processo

9. Errori frequenti

Ogni risultato dipende dalle equazioni che hai scritto: il programma non verifica la correttezza fisica del modello. Vedi anche Verifica dei risultati.