Renvoie la représentation de l'unité d'un ensemble de données en unités SI.
Syntaxe
SIUnits(DataSet)
La syntaxe de la fonction SIUnits se compose des éléments suivants :
Section |
Description |
|---|---|
DataSet |
L'ensemble de données dont l'unité doit être déterminée en unités SI. Toutes les structures de données sont autorisées. Tous les types de données sont autorisés. |
Remarques
Pour les structures de données composées, seule la composante Y est prise en compte. Si l'enregistrement n'a pas d'unité, la fonction renvoie le type de données Empty. Sinon, le résultat est une liste contenant les éléments nommés suivants :
Nom |
Contient |
|---|---|
Échelle |
valeur unique à 64 décimales flottantes avec le facteur d'échelle. Si l'ensemble de données n'a pas d'unité ou une unité de dimension SI inconnue, le facteur d'échelle est égal à zéro. |
Offset |
Valeur scalaire à virgule flottante de 64 bits avec le décalage (offset). |
ExpNum |
Séries de données entières de 32 bits avec les numérateurs exponentiels des sept unités de base SI de l'ordre de m kg s A K mol cd. |
ExpDenom |
Séries de données entières de 32 bits avec les dénominateurs exponentiels des sept unités de base SI. |
La manière d'interpréter les différentes valeurs est décrite dans Représentation interne des unités.
Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
SIUnits(1 mV) |
Renvoie [<Scale> 1.E-3, <Offset> 0.0, <ExpNum> { 2, 1, -3, -1, 0, 0, 0}, <ExpDenom> { 1, 1, 1, 1, 0, 0, 0} ]. L'unité volt (V) correspond en unités SI à m2 kg s-3 A-1. L'échelle est égale à 1.E-3 puisque 1 mV = 10-3V. |
SIUnits(1 Pi) |
Renvoie [<Scale> 3.141592653589793, <Offset> 0.0, <ExpNum> { 0, 0, 0, 0, 0, 0, 0}, <ExpDenom> { 1, 0, 0, 0, 0, 0, 0} ]. L' échelle est égale à π. Tous les exposants du compteur sont égaux à 0, car l'unité Pi est sans dimension. L'exposant nominal de l'unité SI m est égal à 1, ce qui est interprété comme un m/m. |
SIUnits(1 sr) |
Renvoie [<Scale> 1.0, <Offset> 0.0, <ExpNum> { 0, 0, 0, 0, 0, 0, 0}, <ExpDenom> { 2, 0, 0, 0, 0, 0, 0} ]. L'unité stéradian (sr) de l'angle solide est sans dimension et est représentée en unités SI par m2/m2. Grâce à cette forme de représentation, il reste évident qu'il s'agit du rapport entre deux surfaces. Tous les exposants de numérateur sont égaux à 0, car l'unité sr est sans dimension. L'exposant nominal de l'unité SI m est égal à 2, ce qui est interprété comme m2/m2. |
SIUnits(22 °C) |
Renvoie [<Scale> 1.0, <Offset> 273.15, <ExpNum> { 0, 0, 0, 0, 1, 0, 0}, <ExpDenom> { 0, 0, 0, 0, 1, 0, 0} ]. 0 °C correspond à 273,15 K, c'est-à-dire que l'échelle des °C est décalée de 273,15 par rapport à l'échelle des kelvins. Ce décalage est représenté par l'élément Offset. |
SIUnits(2) |
Renvoie [<Scale> 0.0, <Offset> 0.0, <ExpNum> { 0, 0, 0, 0, 0, 0, 0}, <ExpDenom> { 0, 0, 0, 0, 0, 0, 0} ]. La valeur n'a pas d'unité. L'élément Scale est donc égal à zéro. |
SIUnits(2 Dummy) |
Renvoie [<Scale> 0.0, <Offset> 0.0, <ExpNum> { 0, 0, 0, 0, 0, 0, 0}, <ExpDenom> { 0, 0, 0, 0, 0, 0, 0} ]. L'unité "Dummy" est inconnue. L'élément Scale est donc égal à zéro. |