SIUnits (FPScript)

21.09.2021

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.

Voir aussi

Fonction Unit

Fonction UnitType

Fonction UnitSymbol

Gestionnaire d'unités

Grandeurs dans FPScript

Partager l’article ou envoyer par mail :

Vous serez probablement intéressé par les articles suivants :