ReadDataFile (FPScript)
Liest ein Element, z. B. einen Kanal, aus einer Datendatei.
Syntax
ReadDataFile(File, FormatIdentifier, Element, [ CalendarTime = FALSE ], [ Signal = FALSE ], [ XElement ], [ RangeFrom ], [ RangeTo ], [ Duration ], [ DataRange = READDATAFILE_DR_COMPLETE ], [ CustomProperties ] [ , PostProcessing ])
Die Syntax der ReadDataFile-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
File |
Zeichenkette mit dem Pfad der einzulesenden Datei. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette (Dateiname). Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||
FormatIdentifier |
Zeichenkette mit einem Text, der ein unterstütztes Format identifiziert (siehe Anmerkungen). Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||
Element |
Index des Elementes, das aus der Datei ausgelesen werden soll, falls eine Ganzzahl angegeben wird. Normalerweise sind Elemente, die analoge Daten repräsentieren mit positiven Werten mit Eins beginnend durchnummeriert, digitale Daten entsprechend negativ. Name des Elements, das aus der Datei ausgelesen werden soll, falls eine Zeichenkette angegeben wird. Bei hierarchischen Dateiformaten muss der vollständige Elementpfad angegeben werden, falls der Name in der Datei nicht eindeutig ist. Die Null ist für die Zeitdaten reserviert. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 16-Bit Ganzzahl, 32-Bit Ganzzahl, 64-Bit Ganzzahl und Zeichenkette. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||
CalendarTime |
Wahrheitswert, der angibt, dass Zeitinformationen als Kalenderzeiten gelesen werden sollen. Andernfalls liefert die X-Komponente die Zeit in Sekunden seit Beginn der Messung oder relativ zum Triggerzeitpunkt. Dieses Argument wird u. U. für das gewählte Format nicht unterstützt (siehe Anmerkungen) und ggf. ignoriert. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert FALSE gesetzt. |
||||||||||||
Signal |
Wahrheitswert, der angibt, dass Elemente als Signale importiert werden sollen. Dieses Argument wird u. U. für das gewählte Format nicht unterstützt (siehe Anmerkungen) und ggf. ignoriert. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Wahrheitswert. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert FALSE gesetzt. |
||||||||||||
XElement |
Index des Elementes, das für die X-Daten verwendet werden soll, falls eine Ganzzahl angegeben wird. Dieser Index wird nur für Formate verwendet, bei denen das X-Datenelement manuell zugewiesen werden muss. Name des Elements, das aus der Datei ausgelesen werden soll, falls eine Zeichenkette angegeben wird. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 16-Bit Ganzzahl, 32-Bit Ganzzahl, 64-Bit Ganzzahl und Zeichenkette. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||
RangeFrom |
Absoluter oder relativer Zeitpunkt des ersten zu lesenden Werts, wenn das Element Element nicht von Anfang an gelesen werden soll. Wenn CalendarTime auf True gesetzt ist, wird hier eine Kalenderzeit erwartet, ansonsten eine Fließkommazahl. Wird das Argument nicht angegeben, dann wird das durch Element spezifizierte Element vom ersten Wert an gelesen. Dieses Argument wird u. U. für das gewählte Format nicht unterstützt (siehe Anmerkungen) und ggf. ignoriert. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||
RangeTo |
Absoluter oder relativer Zeitpunkt des letzten zu lesenden Werts, wenn das Element Element nicht bis zum Ende gelesen werden soll. Wenn CalendarTime auf True gesetzt ist, wird hier eine Kalenderzeit erwartet, ansonsten eine Fließkommazahl. Wird das Argument nicht angegeben, dann wird das durch Element spezifizierte Element bis zum letzten Wert gelesen. Dieses Argument wird u. U. für das gewählte Format nicht unterstützt (siehe Anmerkungen) und ggf. ignoriert. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||
Duration |
Zeitdauer des Datenausschnitts. Dieser Wert muss angegeben werden, wenn das Element DataRange den Wert READDATAFILE_DR_FROMDURATION, READDATAFILE_DR_DURATIONLAST oder READDATAFILE_DR_FIRSTDURATION hat. Dieses Argument wird u. U. für das gewählte Format nicht unterstützt (siehe Anmerkungen) und ggf. ignoriert. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||
DataRange |
Wert, der angibt, welche Art von Datenausschnitt gebildet werden soll. Das Argument DataRange kann folgende Werte haben:
Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert READDATAFILE_DR_COMPLETE gesetzt. |
||||||||||||
CustomProperties |
Ist eine Liste mit dateiformatabhängigen Eigenschaften, die den Import der Daten signifikant beeinflussen. Erlaubte Datenstrukturen sind Liste. Es sind alle Datentypen erlaubt. Die Einheit des Arguments wird ignoriert. |
||||||||||||
PostProcessing |
Zeichenkette mit einer FPScript Formel, die zum Nachbearbeiten der Daten verwendet wird. data dient hierbei als Platzhalter des zu verrechnenden Elements. Beispiel: Maximum(data) Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind Zeichenkette. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
Anmerkungen
Format |
Beschreibung |
Dateiendungen |
Kalenderzeit (optional) |
Signal (optional) |
---|---|---|---|---|
A&D RA1000/RA2000 |
Datenformat der RA1100/RA2x00-Recorder-Serien von A&D. |
*.dat;*.drt;*.fsd;*.fpp;*.idx |
True /False |
True |
Agilent InfiniiVision 2000/3000 X-Serie |
Format für Oszilloskope der InfiniiVision 2000/3000 X-Serie von Agilent Technologies. |
*.bin |
False |
True |
Airbus AIDASS RDF |
AIDASS Recorded Data File Format von Airbus. |
*.rdf |
True /False |
True |
ASAM COMMON MDF4 |
Binäres Dateiformat zur Aufzeichnung von Messdaten, veröffentlicht von der Association for Standardization of Automation and Measuring Systems (ASAM). |
*.mf4 |
True /False |
True /False |
AstroNova Daxus Data Capture |
Format der Daxus-Datenerfassungssysteme von AstroNova. |
*.dcr;*.scr |
True /False |
True |
AVL iFile |
Binäres Dateiformat von AVL, verwendet bei der Verbrennungsanalyse. |
*.* |
False |
True |
Bosch MDF |
Measurement Data Format z. B. verwendet von der Software INCA von ETAS. |
*.mdf;*.dat |
True /False |
True /False |
Data Translation HPF |
High Performance File Format von Data Translation. |
*.hpf |
True /False |
True /False |
Delphin ProfiSignal |
ProfiSignal HDS Dateiformat von Delphin. |
*.hds |
True /False |
True |
DEWESoft D7D/DXD |
DEWESoft 7 und X-Format von DEWESoft. |
*.d7d;*.dxd |
True /False |
True |
DEWETRON DMD |
DEWETRON Measurement Data-Format von Dewetron. |
*.dmd |
True /False |
True |
European Data Format EDF |
Das European Data Format dient dem Austausch und der Speicherung von Biosignalen und anderen Daten aus biologischen Zeitreihen. |
*.edf |
True /False |
True |
Gantner Q.brixx |
Importschnittstelle zu Q.brixx Messystemen von Gantner. Es muss eine Textdatei mit der Endung .qbrixx angelegt werden, die die IP-Adresse des Messsystems enthält. |
*.qbrixx |
True /False |
True |
Gantner UDBF |
Universal Data Bin File-Dateiformat von Gantner Instruments. |
*.dat |
True /False |
True /False |
GPS Exchange Format GPX |
GPS Exchange Format GPX von Topografix, zum Austausch von GPS Daten. |
*.gpx |
True /False |
True |
Graphtec WR |
Graphtec Schreiberdateien der GL/WR Serien. |
*.dat;*.lmd;*.gdb |
True /False |
True |
HBM catman |
Dateiformat, verwendet von der Datenerfassungssoftware catman von HBM. |
*.bin;*.tst |
True /False |
True /False |
HBM MGCplus MEA |
MGCplus Messdatenerfassungssystem von HBM. |
*.me* |
False |
True |
HBM nSoft Time Series |
nSoft Time Series Format von HBM. |
*.dac |
False |
True /False |
HBM PNRF |
PNRF-Dateiformat von HBM; Nicolet/Odyssey/Vision NRF-Dateiformat. |
*.pnrf;*.nrf |
True /False |
True |
HBM SoMat SIE |
SoMat SIE-Dateiformat von HBM. |
*.sie |
True /False |
True |
HDF Group HDF5 |
Hierarchical Data Format der HDF Group. |
*.h5 |
False |
False |
Head Acoustics HDF |
HEAD acoustics Datafile Format von HEAD acoustics. |
*.hdf |
True /False |
True |
HIOKI HiCORDER |
HiCORDER Rekorder Serie 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 von Hewlett Packard. |
*.sdf;*.* |
False |
True |
IMC FAMOS |
FAMOS-Dateiformat von IMC. |
*.dat;*.* |
True /False |
True /False |
Kistler Open File |
Open File-Dateiformat von Kistler. |
*.open |
False |
True |
LeCroy WaveJet |
Waveform Dateiformat der Oszilloskope der Wavejet Serie. |
*.wfm |
True /False |
True |
MSR Electronics MSR3 |
Datenformat der MSR Datenlogger von MSR Electronics. |
*.msrprj;*.msr3 |
True /False |
True |
National Instruments DASYLab |
DASYLab Dateiformat von National Instruments. |
*.ddf |
True /False |
True |
National Instruments TDM |
National Instruments TDM-Dateiformat; National Instruments Streaming TDMS-Dateiformat. TDMS-Import unterstützt das Zeitformat nicht. |
*.tdm;*.tdms |
True /False |
True /False |
NMEA 0183 |
National Marine Electronics Association Standard 0183. |
*.nmea;*.* |
True /False |
True |
OROS OXF |
NVGate OXF-Dateiformat von OROS. |
*.oxf |
False |
True |
Parker Hannifin SMC |
Dateiformat von Parker Hannifin. Einlesbar sind Originalmessdateien (*.scco) und mit der Kommunikations-Software veränderte Messdateien (*.sccm). |
*.scco;*.sccm;*.scmo |
True /False |
True |
RION WAV |
Dateiformat von RION Co.,Ltd., z.B. verwendet vom DA-21 Recorder. |
*.wav |
True /False |
True |
SEFRAM Recorder |
Datenformat der SEFRAM Recorder. |
*.rec |
True /False |
True |
SYSCOM Instruments XMR/BMR |
Datenformat von SYSCOM Instruments, z.B. verwendet von der MR3000 und MR2002 Recorder Serie. |
*.xmr;*.bmr |
True /False |
True |
TiePie TPS |
Multichannel TPS-Dateiformat von TiePie. |
*.tps |
False |
True |
Unidata NetCDF |
Network Common Data Form, veröffentlicht von 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) und ASCII Logging File Format (.asc) von Vector. |
*.blf*;*.asc |
True /False |
True |
Yokogawa DXAdvanced |
DXAdvanced-Format von Yokogawa. |
*.dad;*.dae |
True /False |
True |
Yokogawa MX100 |
MX100-Format von Yokogawa. |
*.mxd |
True /False |
True /False |
Yokogawa SmartDAC |
SmartDAC-Format von Yokogawa. |
*.gev;*.gds |
True /False |
True |
Yokogawa WDF/WVF |
WDF- und WVF-Format von Yokogawa. |
*.wdf;*.wvf |
True /False |
True |
Verfügbarkeit
FlexPro View, Basic, Professional, Developer Suite
Beispiele
ReadDataFile("c:\\examples\\file.dat", "IMC FAMOS", 1, FALSE, FALSE) |
Import den ersten Kanal aus einer FAMOS-Datei. |