Range (FPScript)

21.09.2021

Détermine des plages globales, glissantes ou par blocs, c'est-à-dire les différences entre les maxima et les minima d'un ensemble de données.

Syntaxe

Range(DataSet, [ Mode = PROCESS_COLUMNS ] [ , IntervalWidth ])

 

La syntaxe de la fonction Range 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.

Pour les types de données complexes, un nombre est formé.

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

Précise comment les matrices de données et les séries de signaux doivent être traitées et si des plages individuelles, glissantes ou par blocs doivent être déterminées. Si vous omettez l'argument, les plages individuelles sont déterminées colonne par colonne.

L'argument Mode peut avoir les valeurs suivantes :

Constante

Signification

PROCESS_COLUMNS

Le traitement se fait colonne par colonne. Le résultat contient une valeur par colonne.

PROCESS_ROWS

Le traitement se fait ligne par ligne. Le résultat contient une valeur par ligne.

PROCESS_COMPLETE

Le traitement est global. Le résultat contient une valeur pour l'ensemble de données.

...plus une constante optionnelle, qui détermine la méthode de calcul.

Constante

Signification

+ CALC_BLOCK

Calcul bloc par bloc. Une valeur est calculée par intervalle.

+ CALC_MOVING

Calcul glissant. Pour chaque valeur de l'ensemble de données, un résultat est déterminé dans l'intervalle spécifié.

Si l'argument n'est pas spécifié, il est défini à la valeur par défaut PROCESS_COLUMNS .

IntervalWidth

Cet argument est nécessaire pour déterminer les plages glissantes et 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, à droite du centre, une valeur de plus qu'à gauche est incluse dans la recherche.

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.

Si DataSet est une valeur scalaire, alors 0 est toujours renvoyé. 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. Lors du calcul des plages glissantes et par blocs, la structure des données du résultat correspond à celle de l'argument. Si, en revanche, l'ensemble de données est une série de données ou un signal, le résultat est une valeur scalaire avec la plage à trouver. Sinon, le résultat est une série de données ou un signal avec une plage par colonne ou ligne.

Disponible dans

FlexPro View, Basic, Professional, Developer Suite

Exemples

Range({4, 6, 9, 3, 5, 4})

Renvoie 6..

Range({4, 6, 9, 3, 5, 4}, PROCESS_COLUMNS + CALC_MOVING, 3)

Renvoie {2., 5., 6., 6., 2., 1.}.

Range({4, 6, 9, 3, 5, 4}, PROCESS_COLUMNS + CALC_BLOCK, 3)

Renvoie {5., 2.}.

Voir aussi

Fonction Maximum

Fonction GlobalMinimum

Objet d'analyse Grandeurs Statistiques

Partager l’article ou envoyer par mail :

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