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 de 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 individuelles, 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 à concaténer doivent être décalées de manière à ce qu'elles suivent sans interruption celles des précédents. 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. La représentation sous forme de courbe permet alors de voir les espaces 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, celles-ci sont concaténées élément par élément et le résultat est une liste avec les éléments concaténés. L'affectation des éléments se fait de préférence via 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 objets de données à concaténer sont décalées de manière à obtenir une série ascendante sans discontinuité. La première valeur des données à concaténer 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 est défini sur TRUE ou omis, le timestamp est ajouté aux données numériques, s'il est présent dans les données d'en-tête des éléments de liste, afin de les convertir en type de données temps calendaire. Si les données ont une unité, il faut alors qu'il y ait une unité avec la dimension SI Temps. Si l'on ne convertit pas en temps calendaire, les unités des données à concaténer doivent être exactement 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 qui a été enregistrée par jour dans des dossiers. |
ConcatenateList('Data2019-08-*') |
Concatène les données d'août 2019 issues d'une mesure qui ont été enregistrées quotidiennement dans des dossiers. |