ChangeUnit (FPScript)
Convertit ou définit l'unité (les unités) d'un ensemble de données.
Syntaxe
ChangeUnit(DataSet, [ Unit ], [ UnitX ] [ , UnitZ ])
La syntaxe de la fonction ChangeUnit se compose des éléments suivants :
Section |
Description |
---|---|
DataSet |
L'ensemble de données avec la ou les unités à définir ou à convertir. Toutes les structures de données sont autorisées, sauf Liste. Les types de données pris en charge sont Virgule flottante de 32 bits, Virgule flottante de 64 bits, Nombre complexe à virgule flottante de 32 bits, Nombre complexe à virgule flottante de 64 bits, Temps calendaire et Période de temps. 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. |
Unit |
Spécifie l'unité cible pour l'ensemble de données ou sa composante Y. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. |
UnitX |
Spécifie l'unité cible pour la composante X de l'ensemble de données. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. |
UnitZ |
Spécifie l'unité cible pour la composante Z de l'ensemble de données. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. |
Remarques
Si DataSet a déjà une unité, alors l'unité est convertie ; sinon, elle est assignée. Si pour l'un des arguments Unit, UnitX ou UnitZ vous spécifiez une chaîne vide, l'unité correspondante sera supprimée. Si vous omettez l'argument, l'unité correspondante restera inchangée. Si la conversion n'est pas possible en raison d'une mauvaise correspondance des dimensions SI, une erreur se produit. Les unités dont la dimension SI est inconnue peuvent seulement être définies ou supprimées, mais pas transformées.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
ChangeUnit(1.4 V, "mV") |
Renvoie 1400. mV. L'unité est convertie. |
ChangeUnit(1.4, "mV") |
Renvoie 1.4 mV. L'unité est définie. |
ChangeUnit(1.4 mV, "") |
Renvoie 1.4. L'unité est supprimées. |
ChangeUnit(2 Pi, "1") |
Renvoie 6.283185307179586. Une unité sans dimension est transformée en unité 1. |
ChangeUnit(Signal, "mV", "ms") |
Les unités Y et X du signal sont définies ou converties. |
ChangeUnit(Signal, , "ms") |
Seule l'unité de la composante X du signal est définie ou convertie. L'unité de la composante Y reste inchangée. |