ChangeUnit (FPScript)

21.09.2021

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.

Voir aussi

Fonction ChangeUnitSymbol

Fonction AdjustUnit

Gestionnaire d'unités

Grandeurs dans FPScript

Opérateur Unit

Partager l’article ou envoyer par mail :

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