ReadDataFile (FPScript)
Lit un élément, tel qu'un canal, à partir d'un fichier de données.
Syntaxe
ReadDataFile(File, FormatIdentifier, Element, [ CalendarTime = FALSE ], [ Signal = FALSE ], [ XElement ], [ RangeFrom ], [ RangeTo ], [ Duration ], [ DataRange = READDATAFILE_DR_COMPLETE ], [ CustomProperties ] [ , PostProcessing ])
La syntaxe de la fonction ReadDataFile se compose des éléments suivants :
Section |
Description |
||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
File |
Chaîne de caractères avec le chemin du fichier à 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. |
||||||||||||
FormatIdentifier |
Chaîne de caractères avec texte qui identifie un format supporté (voir remarques). Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. 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é. |
||||||||||||
Element |
Index de l'élément à lire dans le fichier si un nombre entier est spécifié. Habituellement, les éléments représentant des données analogiques sont numérotés avec des valeurs positives commençant par un, et les données numériques sont numérotées avec des valeurs négatives. Nom de l'élément à lire dans le fichier si une chaîne de caractères est spécifiée. Avec les formats de fichier hiérarchiques, le chemin d'accès complet de l'élément doit être saisi si le nom n'est pas unique dans le fichier. Le zéro est réservé aux données de temps. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Entier de 16 bits, Entier de 32 bits, Entier de 64 bits et Chaîne de caractères. 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. |
||||||||||||
CalendarTime |
Valeur booléenne précisant que les données de temps doivent être lues comme des temps calendaire. Sinon, la composante X fournit le temps en secondes depuis le début de la mesure ou par rapport à l'heure de déclenchement (trigger). Cet argument peut ne pas être supporté pour le format sélectionné (voir remarques) et peut éventuellement ê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 précisant que les éléments doivent être importés sous forme de signaux. Cet argument peut ne pas être supporté pour le format sélectionné (voir remarques) et peut éventuellement ê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 . |
||||||||||||
XElement |
Index de l'élément à utiliser pour les données X si un nombre entier est spécifié. Cet index n'est utilisé que pour les formats qui nécessitent l'attribution manuelle de l'élément de données X. Nom de l'élément à lire dans le fichier si une chaîne de caractères est spécifiée. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Entier de 16 bits, Entier de 32 bits, Entier de 64 bits et Chaîne de caractères. 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é. |
||||||||||||
RangeFrom |
Temps absolu ou relatif de la première valeur à lire si l'élément Element n'est pas à lire dès le début. Si CalendarTime est fixé à True une valeur de temps calendaire est attendue ici ; sinon, une valeur à virgule flottante est attendue. Si l'argument n'est pas fourni, l'élément spécifié par Element est lu à partir de la première valeur. Cet argument peut ne pas être supporté pour le format sélectionné (voir remarques) et peut éventuellement être ignoré. 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 dernière valeur à lire si l'élément Element n'est pas à lire jusqu'au bout. Si CalendarTime est fixé à True une valeur de temps calendaire est attendue ici ; sinon, une valeur à virgule flottante est attendue. Si l'argument n'est pas fourni, l'élément spécifié par Element est lu jusqu'à la dernière valeur. Cet argument n'est pas supporté pour tous les formats (voir la section des remarques) et est ignoré s'il n'est pas applicable. 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 READDATAFILE_DR_FROMDURATION, READDATAFILE_DR_DURATIONLAST ou READDATAFILE_DR_FIRSTDURATION. Cet argument peut ne pas être supporté pour le format sélectionné (voir remarques) et peut éventuellement être ignoré. 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é. |
||||||||||||
DataRange |
Valeur qui spécifie le type de plage de données à créer. L'argument DataRange peut avoir les valeurs suivantes :
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 . |
||||||||||||
CustomProperties |
Une liste avec des propriétés qui dépendent du format de fichier et qui affectent de manière significative l'importation des données. Les structures de données autorisées sont Liste. Tous les types de données sont autorisés. L'unité de l'argument est ignorée. |
||||||||||||
PostProcessing |
Une chaîne de caractère avec une formule FPScript qui est utilisée pour post-traiter les données. data sert dans ce cas d'espace réservé pour l'élément à calculer. Exemple : Maximum(data) Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. 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
Format |
Description |
Extensions de fichiers |
Temps calendaire (facultatif) |
Signal (facultatif) |
---|---|---|---|---|
A&D RA1000/RA2000 |
Format de fichier de la série d'enregistreurs RA1100/RA2x00 de A&D. |
*.dat;*.drt;*.fsd;*.fpp;*.idx |
True /False |
True |
Agilent InfiniiVision 2000/3000 X-Series |
Oscilloscopes InfiniiVision 2000/3000 X-Series d'Agilent Technologies. |
*.bin |
False |
True |
Airbus AIDASS RDF |
AIDASS Recorded Data File format d'Airbus. |
*.rdf |
True /False |
True |
ASAM COMMON MDF4 |
Format de fichier binaire pour le stockage des données de mesure publié par l'Association for Standardization of Automation and Measuring Systems (ASAM). |
*.mf4 |
True /False |
True /False |
AstroNova Daxus Data Capture |
Format des systèmes d'acquisition de données Daxus de AstroNova. |
*.dcr;*.scr |
True /False |
True |
AVL iFile |
Format de fichier binaire de l'AVL, utilisé pour l'analyse de combustion. |
*.* |
False |
True |
Bosch MDF |
Measurement Data Format, utilisé par des logiciels tels que INCA de l'ETAS. |
*.mdf;*.dat |
True /False |
True /False |
Data Translation HPF |
High Pperformance File format de Data Translation. |
*.hpf |
True /False |
True /False |
Delphin ProfiSignal |
Format de fichier ProfiSignal HDS de Delphin. |
*.hds |
True /False |
True |
DEWESoft D7D/DXD |
Format DEWESoft 7 et X de DEWESoft. |
*.d7d;*.dxd |
True /False |
True |
DEWETRON DMD |
DEWETRON Measurement Data format from Dewetron. |
*.dmd |
True /False |
True |
European Data Format EDF |
Le European Data Format est utilisé pour échanger et stocker des biosignaux et d'autres données provenant de séries chronologiques biologiques. |
*.edf |
True /False |
True |
Gantner Q.brixx |
Interface d'importation pour les systèmes de mesure Q.brixx de Gantner. Il faut créer un fichier texte avec l'extension .qbrixx qui contient l'adresse IP du système de mesure. |
*.qbrixx |
True /False |
True |
Gantner UDBF |
Universal Data Bdans File file format de Gantner Instruments. |
*.dat |
True /False |
True /False |
GPS Exchange Format GPX |
GPS Exchange Format GPX de Topografix pour l'échange de données GPS. |
*.gpx |
True /False |
True |
Graphtec WR |
Fichiers d'enregistreurs Graphtec de la série GL/WR. |
*.dat;*.lmd;*.gdb |
True /False |
True |
HBM catman |
Format de fichier utilisé par le logiciel d'acquisition de données catman de HBM. |
*.bin;*.tst |
True /False |
True /False |
HBM MGCplus MEA |
Système d'acquisition de données de mesure MGCplus de HBM. |
*.me* |
False |
True |
HBM nSoft Time Series |
nSoft Time Series format de HBM. |
*.dac |
False |
True /False |
HBM PNRF |
Format de fichier PNRF de HBM ; format de fichier Nicolet/Odyssey/Vision NRF. |
*.pnrf;*.nrf |
True /False |
True |
HBM SoMat SIE |
Format de fichier SoMat SIE de HBM. |
*.sie |
True /False |
True |
HDF Group HDF5 |
Hierarchical Data Format du groupe HDF. |
*.h5 |
False |
False |
Head Acoustics HDF |
HEAD acoustics Datafile Format de HEAD acoustics. |
*.hdf |
True /False |
True |
HIOKI HiCORDER |
Enregistreur HiCORDER séries 8835, 8835-01, 8826, 8841, 8842, 8807-01, 8808-01, 8855, 8860, 8861. |
*.mem;*rec;*.fft;*.rms |
True /False |
True |
HP SDF |
Standard Data Format de Hewlett Packard. |
*.sdf;*.* |
False |
True |
IMC FAMOS |
Format de fichier FAMOS d'IMC. |
*.dat;*.* |
True /False |
True /False |
Kistler Open File |
Format de fichier ouvert de Kistler. |
*.open |
False |
True |
LeCroy WaveJet |
Format de fichier Waveform pour les oscilloscopes de la série WaveJet. |
*.wfm |
True /False |
True |
MSR Electronics MSR3 |
Format de fichier pour les enregistreurs de données MSR de MSR Electronics. |
*.msrprj;*.msr3 |
True /False |
True |
National Instruments DASYLab |
Format de fichier DASYLab de National Instruments. |
*.ddf |
True /False |
True |
National Instruments TDM |
Format de fichier National Instruments TDM ; format de fichier National Instruments Streaming TDMS. L'import TDMS ne prend pas en charge le format de temps. |
*.tdm;*.tdms |
True /False |
True /False |
NMEA 0183 |
National Marine Electronics Association Standard 0183. |
*.nmea;*.* |
True /False |
True |
OROS OXF |
Format de fichier NVGate OXF d'OROS. |
*.oxf |
False |
True |
Parker Hannifin SMC |
Format de fichier de Parker Hannifin. Les fichiers de mesure originaux (*.scco) et les fichiers de mesure modifiés à l'aide du logiciel de communication (*.sccm) peuvent être lus. |
*.scco;*.sccm;*.scmo |
True /False |
True |
RION WAV |
Format de fichier de RION Co.,Ltd. utilisé, par exemple, par l'enregistreur DA-21. |
*.wav |
True /False |
True |
SEFRAM Recorder |
Format de données des SEFRAM Recorder. |
*.rec |
True /False |
True |
SYSCOM Instruments XMR/BMR |
Format de données de SYSCOM Instruments, par exemple utilisé par les séries d'enregistreurs MR3000 et MR2002. |
*.xmr;*.bmr |
True /False |
True |
TiePie TPS |
Format de fichier Multichannel TPS de TiePie. |
*.tps |
False |
True |
Unidata NetCDF |
Network Common Data Format, publié par Unidata. |
*.nc |
True /False |
False |
UFF |
Universal File Format type 58. |
*.uff;*.unv;*.bunv;*.ufa;*.ufb |
True /False |
True |
Vector CAN |
Binary Logging File format (.blf) and ASCII logging file format (.asc) de Vector. |
*.blf*;*.asc |
True /False |
True |
Yokogawa DXAdvanced |
Format DXAdvanced de Yokogawa. |
*.dad;*.dae |
True /False |
True |
Yokogawa MX100 |
Format MX100 de Yokogawa. |
*.mxd |
True /False |
True /False |
Yokogawa SmartDAC |
Format SmartDAC de Yokogawa. |
*.gev;*.gds |
True /False |
True |
Yokogawa WDF/WVF |
Formats WDF et WVF de Yokogawa. |
*.wdf;*.wvf |
True /False |
True |
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
ReadDataFile("c:\\examples\\file.dat", "IMC FAMOS", 1, FALSE, FALSE) |
Importe le premier canal d'un fichier FAMOS. |