Unités et conversions automatiques d’unités

La conversion d’unités vous permet d’associer une unité physique à un Vali. Pour chaque calcul effectué avec ce Vali, la conversion nécessaire sera automatiquement réalisée en arrière-plan. La bibliothèque Pint library sert de base à cette fonctionnalité.

L’exemple ci-dessous montre comment 50 kg sont automatiquement convertis en 110,23 livres (lbs), puisque le champ Formula and unit contient 50kg mais que le Display unit est lbs.

Les préfixes et suffixes sont également appliqués automatiquement, comme illustré lors de la conversion du Display unit du Vali de masse de kg vers g dans l’exemple ci-dessous.

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 le Display unit de vali3 sur yd (yard), vous obtiendrez automatiquement ce résultat calculé et converti : 12.030 yd. Si vous ne spécifiez pas de Display unit pour vali3, une unité sera calculée automatiquement (dans ce cas, ce serait mètre ou centimètre).

Gestion des unités sur les Valis et les formules

Création d’un Vali

Lors de la création d’un nouveau 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’un Vali, selon les différentes options de création.

Modification des unités

Champ Unité d’affichage

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

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

Champ Formule et unité

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

Formules

Si un Vali comporte une formule, la formule détermine l’unité attendue en fonction des variables utilisées. Vous pouvez choisir d’afficher la valeur dans n’importe quelle unité (en utilisant le champ Display unit) qui constitue une conversion valide depuis l’unité de la formule. Le fait de modifier 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 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. Tous les Valis qui ont une unité doivent être enregistrés comme des valeurs avec unité (dans le champ Formula and unit) et utilisés 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 est disponible pour 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 unité non définie à un Vali.

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 aucun Vali existant de ce type, mais les nouveaux Valis créés avec ce Valitype auront la nouvelle unité.

Exigences et pires cas

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

Unités et constantes prises en charge

Requirements Portal prend en charge toutes les default units and conversions définies dans la bibliothèque Pint, ainsi que les default constants.

Lorsque vous travaillez avec des unités dans Requirements Portal, notez les points suivants :

• Les unités et les préfixes sont sensibles à la casse. Par exemple, kilogramme doit toujours être kg et jamais Kg ou KG. Veuillez garder à l’esprit l’unité de 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 ; il faut utiliser planck_constant pour cela.

• 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). Leurs abréviations sont respectivement EUR ou euro et USD et dollar.

• dB ne correspond pas à « decibarn » comme 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, utilisez degC, degF et degK (ou ici simplement K).

  Faites attention lorsque vous utilisez la conversion automatique pour les 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 Pint documentation.

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

• Préfixes décimaux :

  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-
  

• Préfixes binaires :

  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. 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 (celles qui ne sont pas définies dans la bibliothèque Pint) sur la page Settings – Custom Units (accessible en cliquant sur l’icône  en bas à gauche, en sélectionnant Settings dans le menu qui apparaît, puis en sélectionnant Custom Units dans la liste du volet de gauche). Pour créer une nouvelle unité personnalisée, cliquez sur le bouton  en haut à droite et définissez les unités à partir des unités existantes dans la bibliothèque Pint.