SIUnits (FPScript)
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'ensemble de données n'a pas d'unité, la fonction fournit le type de données Empty. Sinon, le résultat est une liste avec les éléments nommés suivants :
Nom |
Contient |
---|---|
Échelle |
Valeur scalaire à virgule flottante de 64 bits avec le facteur d'échelle. Si l'ensemble de données n'a pas d'unité ou a une unité avec une dimension SI inconnue, alors l'échelle est égale à 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. |
Le Représentation interne des unités décrit comment interpréter les valeurs individuelles.
Si un argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété.
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 aux 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 numérateur sont égaux à 0, puisque l'unité Pi est sans dimension. L'exposant du dénominateur de l'unité SI m est égal à 1. Ceci est interprété comme 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. Cette forme de représentation permet de garder à l'esprit qu'il s'agit du rapport de deux surfaces. Tous les exposants du numérateur sont égaux à 0, puisque l'unité sr est sans dimension. L'exposant du dénominateur de l'unité SI m est égal à 2. Ceci 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 l'échelle des Kelvin. Ce décalage est indiqué 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' Échelle 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' Échelle est donc égal à zéro. |