Unités et conversions automatiques d’unités

La conversion d’unités vous permet d’associer une unité physique à une Vali. Pour chaque calcul utilisant cette Vali, la conversion nécessaire sera effectuée automatiquement en arrière-plan. La bibliothèque Pint library sert de base à cette fonctionnalité. La figure Unit Conversion montre comment 50 kg sont automatiquement convertis en 110,23 livres (lbs), puisque le champ Value+Unit contient 50 kg alors que l’unité d’affichage est « lbs ». Les préfixes et suffixes sont également appliqués automatiquement, comme illustré lors du passage de l’unité d’affichage de la Vali Mass de « kg » à « g » dans la vidéo. Notez que les unités doivent correspondre ; toute incompatibilité est signalée par un point d’exclamation sur le nom de la Vali dans Requirements & Systems Portal.

En outre, vous pouvez spécifier une formule $vali3 = $vali1 + $vali2 à l’aide de $vali1 = 10 meter et vali2 = 100 cm. Si vous définissez l’unité d’affichage de vali3 sur yd (yard), vous obtiendrez automatiquement ce résultat calculé et converti : 12.030 yd. Si vous ne spécifiez pas d’unité d’affichage pour vali3, une unité sera calculée automatiquement (dans ce cas, ce serait le mètre ou le centimètre). L’unité de chaque Vali est la même pour tous les utilisateurs qui consultent la Vali. Toutes les unités et constantes prises en charge sont répertoriées dans la Pint Library.

Gestion des unités dans les Valis et les formules

Création d’une Vali

Lors de la création d’une nouvelle Vali (valeur numérique ou formule), deux champs de propriété sont importants :

• Formula and Unit (obligatoire)

  • Pour les valeurs numériques (par ex. 50 kg), ce champ doit contenir la valeur et l’unité

  • Pour les formules (par ex. $wheel1.mass+$wheel2.mass), l’unité résulte du calcul.

• Display Unit (facultatif - s’il est vide, l’unité d’affichage sera basée sur les unités du champ Formula and Unit)

Le tableau ci-dessous présente un résumé du comportement attendu lors de la création d’une Vali, selon les différentes options de création :

Modification des unités

Champ Display Unit

Il est toujours possible de modifier le champ Display Unit tant que l’unité d’affichage correspond à une conversion valide de l’unité utilisée (ou calculée via des formules) dans le champ Formula and Unit. En cas d’incompatibilité de dimensions, Requirements & Systems Portal l’indiquera par un point d’exclamation et un message sur la Vali.

Lorsque l’unité d’affichage est remplacée par une valeur correspondant à une conversion valide (par ex. s vers ms ou m/s vers km/s), la Vali sera recalculée et affichée dans l’unité correspondante après conversion, par ex. 100 s = 100 000 ms.

Champ Formula and Unit

Si une Vali est simplement une valeur numérique (et non une formule), vous pouvez modifier l’unité, par ex. de m à s. La Vali deviendra simplement 100 s au lieu de 100 m. Toutefois, si après cette modification l’unité d’affichage ne correspond plus dimensionnellement à la nouvelle unité, Requirements & Systems Portal indiquera une incompatibilité de dimensions et l’unité d’affichage devra être ajustée.

Formules

Si une Vali comporte une formule, c’est la formule qui détermine l’unité attendue en fonction des variables utilisées. Vous pouvez choisir d’afficher la valeur dans n’importe quelle unité (à l’aide du champ Display Unit) correspondant à une conversion valide depuis l’unité de la formule. Le passage de l’unité d’affichage de m/s à km/s affichera la valeur en conséquence. Il est possible de modifier l’unité d’affichage de m/s à m, mais Requirements & Systems Portal signalera un problème de dimension d’unité.

Valeurs sans dimension

Les valeurs sans dimension peuvent être utilisées dans les multiplications et les divisions, mais pas dans les additions et les soustractions avec des valeurs ayant une unité, car les unités ne seront pas compatibles. Toutes les Valis ayant une unité doivent être enregistrées comme des valeurs avec unité (dans le champ Formula and Unit) et utilisées comme paramètres dans les formules (ce qui signifie qu’aucun nombre « magique » ne doit être utilisé).

Les unités non reconnues (« unités non définies ») sont également considérées comme sans dimension.

Unités non définies

Un paramètre distinct permet d’autoriser l’utilisation d’unités non définies. Si cette option est activée (paramètre par défaut), il est possible d’ajouter des unités non prises en charge, mais un avertissement sera créé. Si elle est désactivée, il n’est pas possible d’attribuer à une Vali une unité non définie.

Modification des unités de Valitype

L’unité d’un Valitype ne peut être modifiée que vers une autre unité ayant la même dimensionnalité que l’unité d’origine. Cette modification n’affectera aucune Vali existante de ce type, mais les nouvelles Valis créées avec ce Valitype auront la nouvelle unité.

Exigences et cas les plus défavorables

Les exigences (valeurs min/max) et les cas les plus défavorables sont toujours affichés dans la même unité que celle de la Vali. Si l’unité est modifiée, les exigences et les cas les plus défavorables seront également recalculés pour correspondre à l’unité sélectionnée.

Unités et constantes prises en charge

Requirements & Systems Portal prend en charge toutes les unités et conversions par défaut définies dans la bibliothèque Pint, ainsi que les constantes par défaut.

Veuillez noter les points suivants lorsque vous travaillez avec des unités dans Requirements & Systems Portal :

• Les unités et les préfixes sont sensibles à la casse. Par exemple, kilogramme doit toujours être écrit « kg » et jamais « Kg » ou « KG ». Veuillez garder à l’esprit la Pint Library lorsque vous travaillez avec des unités et que vous n’êtes pas sûr de la capitalisation.

• L’heure s’abrège par « h » ou « hr ». « h » ne peut pas être utilisé pour représenter la constante de Planck ; pour cela, il faut utiliser « planck_constant »

• L’euro et le dollar sont pris en charge comme unités, et leur conversion a été fixée à 1 EUR = 1,123 USD (cette conversion peut être modifiée dans le panneau d’administration pour correspondre à la situation économique actuelle). Ils sont abrégés respectivement en « EUR » ou « euro » et « USD » et « dollar »

• « dB » ne correspond pas à « decibarn » comme ce serait le cas dans la liste d’unités par défaut, mais à sa propre unité sans dimension « decibel ». Les autres unités logarithmiques (par ex. dBW) sont considérées comme des unités non définies et sont donc traitées de la même manière que les unités sans dimension. Aucune conversion automatique n’est prévue entre les échelles linéaires et logarithmiques (par ex. dBW vers W)

• Pour les unités de température, veuillez utiliser degC, degF et degK (ou ici simplement K)

Faites attention lorsque vous utilisez la conversion automatique pour des valeurs de température. Les températures sont des unités « non multiplicatives » et présentent un comportement particulier, expliqué plus en détail dans la documentation Pint.

Les préfixes suivants peuvent être utilisés :

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-  
déci- =  1e-1  = d-  
déca- =  1e+1  = da- = deka  
hecto- = 1e2   = h-  
kilo- =  1e3   = k-  
méga- =  1e6   = M-  
giga- =  1e9   = G-  
téra- =  1e12  = T-  
péta- =  1e15  = P-  
exa- =   1e18  = E-  
zetta- = 1e21  = Z-  
yotta- = 1e24  = Y-  

Binary prefixes

kibi- = 2^10 = Ki-  
mébi- = 2^20 = Mi-  
gibi- = 2^30 = Gi-  
tébi- = 2^40 = Ti-  
pébi- = 2^50 = Pi-  
exbi- = 2^60 = Ei-  
zébi- = 2^70 = Zi-  
yobi- = 2^80 = Yi-  

Toute combinaison de préfixe et d’unité peut être utilisée, par exemple, ks = kiloseconds, puisque le préfixe et l’unité sont tous deux définis (1 kilosecond = 1000 seconds).

Unités non prises en charge

L’utilisation d’opérateurs comme unités n’est pas prise en charge. Par exemple %, -, &, $, #, °. Ces Valis seront traitées comme sans dimension et un avertissement warning (avec le code 2115) sera créé. Par exemple, l’unité % ne sera pas traitée comme un pourcentage (50% = 0.5) mais comme la valeur brute (50).

Unités personnalisées

Les administrateurs peuvent définir des unités personnalisées dans la page Settings, qui n’est visible que par les utilisateurs administrateurs. Les administrateurs peuvent créer des unités personnalisées qui ne sont pas définies dans la bibliothèque Pint. Pour accéder aux paramètres Custom Units, cliquez sur l’icône Settings(1) et accédez à la section Custom Units(2) dans le menu des paramètres.

Les administrateurs peuvent ajouter de nouvelles unités personnalisées en cliquant sur l’icône + ou sur « Ajouter une unité personnalisée »(3) et définir les unités à l’aide des unités existantes dans la bibliothèque Pint.