ConcatenateList (FPScript)
Concatène tous les éléments d'une liste à une série de données ou à un signal, ou les éléments de plusieurs listes en une seule liste avec des séries de données ou des signaux.
Syntaxe
ConcatenateList(List, [ CalendarTime = TRUE ], [ ShiftXValues = FALSE ] [ , InsertVoidValues = FALSE ])
La syntaxe de la fonction ConcatenateList se compose des éléments suivants :
Section |
Description |
|---|---|
List |
Une liste dont les éléments doivent être concaténés, ou une liste de listes avec le même nombre d'éléments qui doivent être concaténés élément par élément. Les éléments de la liste à concaténer doivent être soit des valeurs scalaires, des signaux, des courbes 3D ou des séries de données. Les structures de données autorisées sont Liste. Tous les types de données sont autorisés. |
CalendarTime |
TRUE, si les valeurs du temps doivent être transformées en temps absolu avant la concaténation. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. 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 TRUE . |
ShiftXValues |
TRUE, si les valeurs X des signaux à annexer doivent être décalées de manière à ce qu'elles se connectent de manière transparente à celles du prédécesseur respectif. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. 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 FALSE . |
InsertVoidValues |
TRUE si les segments concaténés doivent être séparés par une valeur invalide chacun. Lorsqu'ils sont affichés sous forme de courbe, vous pouvez alors voir les écarts entre les segments. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. 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 FALSE . |
Remarques
Si une liste de listes est spécifiée, elles sont concaténées élément par élément et le résultat est une liste avec les éléments concaténés. Les éléments sont de préférence affectés par leurs noms d'éléments. Si une seule liste est spécifiée, ses éléments sont concaténés et le résultat est une série de données, un signal ou une courbe 3D. Une liste vide est interprétée comme une liste avec zéro liste, c'est-à-dire que le résultat est à nouveau une liste vide.
Si ShiftXValues a la valeur TRUE, les valeurs X des ensembles de données à ajouter sont décalées de manière à obtenir une série ascendante sans sauts. La première valeur de l'ensemble de données ajouté correspond alors à la dernière valeur du prédécesseur plus la différence entre la dernière et l'avant-dernière valeur. Si les éléments de la liste sont des séries de données, cet argument est ignoré.
Si CalendarTime a la valeur TRUE ou est omis, alors, aussi longtemps qu'il est présent dans les informations d'en-tête des éléments de la liste, l'horodatage est ajouté aux données numériques afin de les convertir au type de données temps calendaire. Si les données ont déjà une unité, alors une unité avec la dimension SI temps doit être présente. Si elles ne sont pas converties en temps calendaire, alors les unités des données à concaténer doivent être identiques.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
ConcatenateList(MyList) |
Concatène tous les éléments de la liste MyList. |
Dim l = ['Data2019-08-09','Data2019-08-10','Data2019-08-11'] |
Concatène les données d'une mesure qui s'est étendue sur trois jours et a été stockée dans des dossiers par jour. |
ConcatenateList('Data2019-08-*') |
Concatène les données d'août 2019 d'une mesure qui s'est étendue sur trois jours et a été stockée dans des dossiers par jour. |