ReadTextData (FPScript)

21.09.2021

Lit un ou plusieurs ensembles de données à partir d'un fichier texte.

Syntaxe

ReadTextData(TextFile, [ Schema ], [ ChannelIdentifier ], [ CalendarTime = FALSE ], [ Signal = FALSE ], [ DataRange = READDATAFILE_DR_COMPLETE ], [ RangeFrom ], [ RangeTo ] [ , Duration ])

 

La syntaxe de la fonction ReadTextData se compose des éléments suivants :

Section

Description

TextFile

Chaîne de caractères avec le chemin du fichier texte à lire.

Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères (nom du fichier).

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.

Schema

Nom d'alias d'un schéma stocké dans la base de données projet qui contient tous les paramètres nécessaires à l'importation, ou le chemin d'un schéma XML stocké sur le disque dur, ou tous les paramètres nécessaires sous forme de chaîne XML.

L'argument Schema peut avoir les valeurs suivantes :

Constante

Signification

READTEXTDATA_SCHEMA_COMTRADE

Schéma de lecture des fichiers texte IEEE Comtrade.

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é.

ChannelIdentifier

Numéro du canal (commençant par 1) ou des canaux à lire. Si aucun numéro de canal n'est spécifié, tous les canaux sont retournés ou, s'ils sont présents, la sélection du schéma choisi est utilisée. Si une valeur scalaire est spécifiée en tant que ChannelIdentifier le canal est renvoyé sous forme de série de données ou de signal. Sinon, les canaux sont renvoyés sous forme de liste.

Les structures de données autorisées sont Scalaire et Séries de données. Tous les types de données entiers sont autorisés.

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é.

CalendarTime

Valeur booléenne indiquant que les données temporelles doivent être lues en tant que temps calendaires. Sinon, la composante X fournit le temps en secondes depuis le début de la mesure. Cet argument peut ne pas être pris en charge par le format sélectionné et, dans ce cas, il peut être ignoré.

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 .

Signal

Valeur booléenne spécifiant que les éléments doivent être lus comme des signaux. Cet argument peut ne pas être pris en charge par le format sélectionné et, dans ce cas, peut être ignoré.

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 .

DataRange

Valeur qui spécifie le type de plage de données à créer.

L'argument DataRange peut avoir les valeurs suivantes :

Constante

Signification

READTEXTDATA_DR_COMPLETE

La plage complète des données est lue.

READTEXTDATA_DR_FROMTO

Les données allant de RangeFrom à RangeTo seront lues.

READTEXTDATA_DR_FROMDURATION

Les données allant de RangeFrom à RangeFrom + Duration seront lues.

READTEXTDATA_DR_DURATIONLAST

La plage de données avec la durée Duration jusqu'à la dernière valeur sera lue.

READTEXTDATA_DR_FIRSTDURATION

La plage de données avec la durée Duration à partir de la première valeur sera lue.

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 READDATAFILE_DR_COMPLETE .

RangeFrom

Temps absolu ou relatif de la première valeur à lire si les données ne doivent pas être lues depuis le début. Si l'ensemble de données X contient des valeurs de temps calendaire, une valeur de temps calendaire est attendue ici ; sinon, une valeur à virgule flottante est attendue. Si l'argument n'est pas spécifié ou si aucun ensemble de données X n'est affecté aux ensembles de données, les données sont lues depuis le début de la première valeur.

Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés.

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é.

RangeTo

Temps absolu ou relatif de la première valeur à lire si les données ne sont pas lues jusqu'à la fin. Si l'ensemble de données X contient des valeurs de temps calendaire, une valeur de temps calendaire est attendue ici ; sinon, une valeur à virgule flottante est attendue. Si l'argument n'est pas spécifié ou si aucun ensemble de données X n'est affecté aux ensembles de données, les données sont lues jusqu'à la dernière valeur.

Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés.

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é.

Duration

Durée de la plage de données. Cette valeur doit être précisée si l'élément DataRange a la valeur READTEXTDATA_DR_FROMDURATION, READTEXTDATA_DR_DURATIONLAST ou READTEXTDATA_DR_FIRSTDURATION lorsqu'il est considéré comme un tout. Cet argument n'est pris en charge que si un ensemble de données X a été spécifié.

Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés.

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

Si un fichier est importé à l'aide de l'assistant d'importation de données textuelles, il est possible d'enregistrer le schéma avec les paramètres dans la base de données des modèles. Dans ce cas, le nom d'alias peut être utilisé pour accéder aux paramètres. Si les paramètres ne sont pas stockés sous forme de schéma, vous pouvez également transmettre les paramètres directement sous la forme d'une chaîne XML de la fonction. Vous pouvez enregistrer un schéma stocké dans un fichier XML dans la boîte de dialogue Organiser. Vous pouvez également accéder directement à ce type de fichier XML dans ReadTextData. Si une entrée du fichier ne peut pas être interprétée comme un nombre, alors une valeur à virgule flottante invalide est saisie à l'emplacement correspondant dans le résultat.

Disponible dans

FlexPro View, Basic, Professional, Developer Suite

Exemples

ReadTextData("c:\\examples\\file.txt", "", 2)

Lit le deuxième canal à partir du fichier texte c:\examples\file.txt. Les paramètres par défaut sont utilisés pour l'importation.

Voir aussi

Assistant d'importation de fichier texte

Importation de données

Partager l’article ou envoyer par mail :

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