ReadDataFile (FPScript)

21.09.2021

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:

Konstante

Bedeutung

READDATAFILE_DR_COMPLETE

Der Datenbereich wird vollständig eingelesen.

READDATAFILE_DR_FROMTO

Es wird der Datenbereich von RangeFrom bis RangeTo eingelesen.

READDATAFILE_DR_FROMDURATION

Es wird der Datenbereich von RangeFrom bis RangeFrom + Duration eingelesen.

READDATAFILE_DR_DURATIONLAST

Es wird der Datenbereich mit der Zeitdauer Duration bis zum letzten Wert eingelesen.

READDATAFILE_DR_FIRSTDURATION

Es wird der Datenbereich mit der Zeitdauer Duration vom ersten Wert an eingelesen.

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.

Siehe auch

Datenimport

Artikel teilen oder als Email versenden:

Diese Beiträge könnten Sie ebenfalls interessieren