Sum (FPScript)
Calcule la somme ou la somme carrée de toutes les valeurs d'un ensemble de données.
Syntaxe
Sum(DataSet, [ Mode = SUM_VAL + PROCESS_COLUMNS ] [ , IntervalWidth ])
La syntaxe de la fonction Sum se compose des éléments suivants :
Section |
Description |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DataSet |
L'ensemble de données à évaluer. Toutes les structures de données sont autorisées. Tous les types de données numériques sont autorisé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. |
||||||||||||||||||||
Mode |
Détermine le type de somme. Précise comment les matrices de données et les séries de signaux doivent être traitées et si les sommes individuelles, flottantes ou en bloc doivent être déterminées. L'argument Mode peut avoir les valeurs suivantes :
...plus une constante, qui détermine le traitement des matrices de données et des séries de signaux....
...plus une constante optionnelle qui détermine la méthode de calcul :
Si l'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é. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut SUM_VAL + PROCESS_COLUMNS . |
||||||||||||||||||||
IntervalWidth |
Cet argument est nécessaire pour déterminer les sommes glissantes et les sommes par blocs. La largeur de l'intervalle spécifie ensuite le nombre de valeurs à examiner. La largeur doit être un nombre impair. Sinon, l'intervalle est asymétrique, et une valeur supplémentaire est incluse dans le calcul à droite du centre par opposition à la gauche. Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés. La valeur doit être supérieure ou égale à 1. Si l'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é. |
Remarques
Le résultat est toujours du type de données Virgule flottante de 64 bits.
Une valeur scalaire est retournée sans modification. Pour les signaux et les séries de signaux, la composante Y est traitée et la composante X ou Z est copiée, si possible. Pour le calcul des valeurs moyennes glissantes et par blocs, la structure des données du résultat correspond à celle de l'argument. Si, en revanche, DataSet est une série de données ou un signal, le résultat est une valeur scalaire avec la somme recherchée ; sinon, le résultat est une série de données ou un signal avec une somme par colonne ou ligne.
Si DataSet est complexe, une somme complexe est calculée. Le type de données du résultat est toujours une valeur réelle ou complexe à virgule flottante de 64 bits.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
Sum({1, 3, 7, 4}) |
Renvoie 15. |
Sum({1, 3, 7, 4}, SUM_SQUARE) |
Renvoie 75. |