Unità e conversioni automatiche delle unità
La conversione delle unità consente di collegare un'unità fisica a un Vali. Per ogni calcolo con questo Vali, la conversione necessaria verrà eseguita automaticamente nel back-end. A questo scopo viene utilizzata come base la Pint library. La figura Unit Conversion mostra come 50 kg vengano convertiti automaticamente in 110,23 libbre (lbs), poiché il campo Value+Unit contiene 50 kg ma la Display Unit è “lbs”. Anche prefissi e suffissi vengono applicati automaticamente, come mostrato quando nel video la Display Unit del Mass Vali viene convertita da “kg” a “g”. Si noti che le unità devono corrispondere e qualsiasi mancata corrispondenza viene indicata da un punto esclamativo sul nome del Vali da parte di Requirements & Systems Portal.
Conversione delle unità - I valori vengono convertiti automaticamente da Requirements & Systems Portal applicando unità, prefissi e suffissi diversi
Inoltre, è possibile specificare una formula $vali3 = $vali1 + $vali2 usando $vali1 = 10 meter e vali2 = 100 cm. Se si imposta la Display Unit di vali3 su yd (yard), si otterrà automaticamente questo risultato calcolato e convertito: 12.030 yd. Se non si specifica una Display Unit per vali3, verrà calcolata automaticamente un'unità (in questo caso sarebbe metro o centimetro). L'unità di ciascun Vali è la stessa per tutti gli utenti che visualizzano il vali. Tutte le unità e le costanti supportate sono elencate nella Pint Library.
Gestione delle unità nei Vali e nelle formule
Creazione di un Vali
Quando si crea un nuovo Vali (valore numerico o formula) ci sono due campi proprietà importanti:
-
Formula and Unit (obbligatorio)
-
Per i valori numerici (ad es. 50 kg) questo campo deve contenere il valore e l'unità
-
Per le formule (ad es. $wheel1.mass+$wheel2.mass) l'unità risulta dal calcolo.
-
-
Display Unit (facoltativo - se vuoto, la Display Unit sarà basata sulle Units del campo Formula and Unit)
La tabella seguente mostra un riepilogo del comportamento previsto per la creazione di un Vali, a seconda delle diverse opzioni di creazione:
Campo Formula and Unit |
Campo Display Unit |
Comportamento previsto |
|---|---|---|
valore numerico e nessuna unità |
nessuna unità |
viene creato un valore adimensionale |
valore numerico e nessuna unità |
unità |
avviso di dimensione dell'unità sul Vali |
valore numerico e un'unità specificata |
nessuna unità |
viene creato un valore con l'unità specificata e visualizzato nell'unità del campo Formula and Unit |
valore numerico e un'unità specificata |
unità |
viene creato un valore con l'unità specificata e visualizzato nell'unità del campo Display Unit (le unità must corrispondono) |
una formula (nessuna unità necessaria) |
nessuna unità |
la Display Unit verrà calcolata automaticamente dalla formula |
una formula (nessuna unità necessaria) |
unità |
il risultato della formula verrà visualizzato nella Display Unit (le unità must corrispondono) |
una formula e un'unità personalizzata |
nessuna unità |
|
una formula e un'unità personalizzata |
unità |
|
Vali con un tipo |
fisso |
l'unità verrà presa automaticamente dall'unità del tipo (è possibile modificarla successivamente purché si rimanga nella stessa dimensionalità) |
Modifica delle unità
Campo Display Unit
È sempre possibile modificare il campo Display Unit purché la Display Unit corrisponda a una conversione valida dell'unità utilizzata (o calcolata tramite formule) nel campo Formula and Unit. Se c'è una mancata corrispondenza dimensionale, Requirements & Systems Portal lo indicherà con un punto esclamativo e un messaggio sul Vali.
Quando la Display Unit viene modificata in qualcosa che rappresenta una conversione valida (ad es. s in ms o m/s in km/s), il Vali verrà ricalcolato e visualizzato nell'unità corrispondente dopo la conversione, ad es. 100 s = 100 000 ms.
Campo Formula and Unit
Se un Vali è solo un valore numerico (non una formula), è possibile cambiare l'unità ad es. da m a s. Il Vali diventerà semplicemente 100 s invece di 100 m. Tuttavia, se dopo la modifica la Display Unit non corrisponde dimensionalmente alla nuova unità, Requirements & Systems Portal indicherà una mancata corrispondenza dimensionale e la Display Unit dovrà essere regolata.
Formule
Se un Vali ha una formula, la formula determina l'unità prevista in base alle variabili utilizzate. È possibile scegliere di visualizzare il valore in qualsiasi unità (usando il campo Display Unit) che rappresenti una conversione valida dell'unità della formula. Modificando la Display Unit da m/s a km/s il valore verrà visualizzato di conseguenza. È possibile modificare la Display Unit da m/s a m ma Requirements & Systems Portal indicherà un problema di dimensione dell'unità.
Valori adimensionali
I valori adimensionali possono essere usati in moltiplicazioni e divisioni, ma non in addizioni e sottrazioni con valori che hanno un'unità, perché le unità non saranno compatibili. Tutti i Vali che hanno un'unità dovrebbero essere salvati come valori con un'unità (nel campo Formula and Unit) e usati come parametri nelle formule (cioè non dovrebbero essere usati numeri “magici”).
Anche le unità non riconosciute (“unità non definite”) sono considerate adimensionali.
Unità non definite
È disponibile un'impostazione separata per consentire l'uso di unità non definite. Se è abilitata (impostazione predefinita), è possibile aggiungere unità non supportate ma verrà creato un avviso. Se è disabilitata, non è possibile assegnare a un Vali un'unità non definita.
Modifica delle unità del Valitype
Un'unità di un Valitype può essere modificata solo in un'unità diversa che abbia la stessa dimensionalità dell'unità originale. Questa modifica non influirà sui Vali esistenti di quel tipo, ma i nuovi Vali creati con questo Valitype avranno la nuova unità.
Requisiti e casi peggiori
I requisiti (valori min/max) e i casi peggiori vengono sempre visualizzati nella stessa unità del Vali. Se l'unità viene modificata, anche i requisiti e i casi peggiori verranno ricalcolati per corrispondere all'unità selezionata.
Unità e costanti supportate
Requirements & Systems Portal supporta tutte le unità e conversioni predefinite definite nella Pint library, nonché le costanti predefinite.
Tenere presente quanto segue quando si lavora con le unità in Requirements & Systems Portal:
-
Unità e prefissi distinguono tra maiuscole e minuscole. Ad esempio, kilogram dovrebbe essere sempre “kg” e mai “Kg” o “KG”. Tenere presente la Pint Library quando si lavora con le unità e non si è sicuri della capitalizzazione.
-
Hour è abbreviato come 'h' o 'hr'. 'h' non può essere usato per rappresentare la costante di Planck; per questo si dovrebbe usare 'planck_constant'
-
Euro e dollaro sono supportati come unità e la loro conversione è fissata a 1 EUR = 1.123 USD (questa conversione può essere modificata nell'Admin Panel per riflettere l'economia corrente). Le abbreviazioni sono rispettivamente 'EUR' o 'euro' e 'USD' e 'dollar'
-
'dB' non corrisponde a 'decibarn' come avverrebbe nell'elenco predefinito delle unità, ma è associato alla propria unità adimensionale 'decibel'. Altre unità logaritmiche (ad es. dBW) sono considerate unità non definite e quindi vengono gestite allo stesso modo delle unità adimensionali. Non è prevista alcuna conversione automatica tra scale lineari e logaritmiche (ad es. da dBW a W)
-
Per le unità di temperatura utilizzare degC, degF e degK (oppure anche semplicemente K)
Prestare attenzione quando si utilizza la conversione automatica per i valori di temperatura. Le temperature sono unità “non moltiplicative” e hanno un comportamento particolare, spiegato più in dettaglio nella Pint documentation.
È possibile utilizzare i seguenti prefissi:
Decimal prefixes
yocto- = 1e-24 = y- zepto- = 1e-21 = z- atto- = 1e-18 = a- femto- = 1e-15 = f- pico- = 1e-12 = p- nano- = 1e-9 = n- micro- = 1e-6 = u- = µ- milli- = 1e-3 = m- centi- = 1e-2 = c- deci- = 1e-1 = d- deca- = 1e+1 = da- = deka hecto- = 1e2 = h- kilo- = 1e3 = k- mega- = 1e6 = M- giga- = 1e9 = G- tera- = 1e12 = T- peta- = 1e15 = P- exa- = 1e18 = E- zetta- = 1e21 = Z- yotta- = 1e24 = Y-
Binary prefixes
kibi- = 2^10 = Ki- mebi- = 2^20 = Mi- gibi- = 2^30 = Gi- tebi- = 2^40 = Ti- pebi- = 2^50 = Pi- exbi- = 2^60 = Ei- zebi- = 2^70 = Zi- yobi- = 2^80 = Yi-
È possibile utilizzare qualsiasi combinazione di prefisso e unità, ad esempio, ks = kiloseconds, poiché sia il prefisso sia l'unità sono definiti (1 kilosecond = 1000 seconds).
Unità non supportate
L'uso di operatori come unità non è supportato. Ad esempio %, -, &, $, #, °. Questi valori saranno trattati come adimensionali e verrà creato un avviso (con codice 2115). Ad esempio, l'unità % non verrà trattata come percentuale (50% = 0.5) ma come valore grezzo (50).
Unità personalizzate
Gli amministratori possono definire unità personalizzate nella pagina Settings, visibile solo agli utenti amministratori. Gli amministratori possono creare unità personalizzate non definite nella libreria Pint. Per accedere alle impostazioni di Custom Units, fare clic sull'icona Settings(1) e passare alla sezione Custom Units(2) nel menu delle impostazioni.

Gli amministratori possono aggiungere nuove unità personalizzate facendo clic sull'icona + o su “Aggiungi unità personalizzata”(3) e definire le unità con le unità esistenti nella libreria Pint.