Lee un elemento, por ejemplo, un canal, de un archivo de datos.
Sintaxis
ReadDataFile(File, FormatIdentifier, Element, [ CalendarTime = FALSE ], [ Signal = FALSE ], [ XElement ], [ RangeFrom ], [ RangeTo ], [ Duration ], [ DataRange = READDATAFILE_DR_COMPLETE ], [ CustomProperties ] [ , PostProcessing ])
La sintaxis de la función ReadDataFile consta de los siguientes elementos:
Parte |
Descripción |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
File |
Cadena con la ruta del archivo que se va a importar. Aquí también se puede especificar una ruta relativa a la base de datos guardada. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Cadena (nombre del archivo). Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||||||||
FormatIdentifier |
Cadena con un texto que identifica un formato admitido (véanse las observaciones). Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Cadena. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||
Element |
Índice del elemento que se va a leer del archivo si se especifica un entero. Normalmente, los elementos que representan datos analógicos se numeran con valores positivos empezando por uno, los datos digitales se numeran del mismo modo, pero con valores negativos. Nombre del elemento que se va a leer del archivo si se especifica una cadena. Para los formatos de archivo jerárquicos, debe especificarse la ruta completa del elemento si el nombre del archivo no es único. El cero se reserva para los datos de tiempo. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Entero de 16 bits, Entero de 32 bits, Entero de 64 bits y Cadena. Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista. |
||||||||||||
CalendarTime |
Valor booleano que especifica que la información de tiempo debe leerse como tiempo del calendario. De lo contrario, el componente X proporciona el tiempo en segundos desde el inicio de la medición o en relación con el instante de trigger. Este argumento puede no ser compatible con el formato seleccionado (véanse las observaciones) y puede ser ignorado. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Valor booleano. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. Se establece el valor predeterminado FALSE si no se especifica el argumento. |
||||||||||||
Signal |
Valor booleano que especifica que los elementos deben importarse como señales. Este argumento puede no ser compatible con el formato seleccionado (véanse las observaciones) y puede ser ignorado. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Valor booleano. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. Se establece el valor predeterminado FALSE si no se especifica el argumento. |
||||||||||||
XElement |
Índice del elemento que se utilizará para los datos X si se especifica un entero. Este índice solo se utiliza para los formatos en los que el elemento de datos X debe asignarse manualmente. Nombre del elemento que se va a leer del archivo si se especifica una cadena. Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Entero de 16 bits, Entero de 32 bits, Entero de 64 bits y Cadena. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||
RangeFrom |
Instante absoluto o relativo del primer valor que se va a leer si el elemento Element no se va a leer desde el principio. Si CalendarTime se ajusta a True, aquí se espera un tiempo del calendario; en caso contrario, un número en coma flotante. Si no se especifica el argumento, el elemento especificado por Element se lee a partir del primer valor. Este argumento puede no ser compatible con el formato seleccionado (véanse las observaciones) y puede ser ignorado. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales. No se permiten valores inválidos en este argumento. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||
RangeTo |
Instante absoluto o relativo del último valor que se va a leer si el elemento Element no se va a leer hasta el final. Si CalendarTime se ajusta a True, aquí se espera un tiempo del calendario; en caso contrario, un número en coma flotante. Si no se especifica el argumento, el elemento especificado por Element se lee a partir del primer valor. Este argumento puede no ser compatible con el formato seleccionado (véanse las observaciones) y puede ser ignorado. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales. No se permiten valores inválidos en este argumento. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||
Duration |
Duración del segmento de datos. Este valor debe especificarse si el elemento DataRange tiene el valor READDATAFILE_DR_FROMDURATION, READDATAFILE_DR_DURATIONLAST o READDATAFILE_DR_FIRSTDURATION. Este argumento puede no ser compatible con el formato seleccionado (véanse las observaciones) y puede ser ignorado. Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales. No se permiten valores inválidos en este argumento. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
||||||||||||
DataRange |
Valor que especifica el tipo de segmento de datos que se va a crear. El argumento DataRange puede tener los siguientes valores:
Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. Se establece el valor predeterminado READDATAFILE_DR_COMPLETE si no se especifica el argumento. |
||||||||||||
CustomProperties |
Es una lista de propiedades dependientes del formato de archivo que influyen significativamente en la importación de datos. Las estructuras de datos permitidas son Lista. Se permiten todos los tipos de datos. Se ignora la unidad del argumento. |
||||||||||||
PostProcessing |
Cadena con una fórmula FPScript que se utiliza para posprocesar los datos. data sirve como marcador de posición del elemento que se va a calcular. Ejemplo: Maximum(data) Las estructuras de datos permitidas son Valor escalar. Los tipos de datos permitidos son Cadena. Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso. |
Notas
Formato |
Descripción |
Extensiones de archivos |
Tiempo del calendario (opcional) |
Señal (opcional) |
|---|---|---|---|---|
A&D RA1000/RA2000 |
Formato de datos de las series RA1100/RA2x00-Recorder de A&D. |
*.dat;*.drt;*.fsd;*.fpp;*.idx |
True / False |
True |
Serie Agilent InfiniiVision 2000/3000 X |
Formato para osciloscopios de la serie InfiniiVision 2000/3000 X de Agilent Technologies. |
*.bin |
False |
True |
Airbus AIDASS RDF |
Formato AIDASS Recorded Data File de Airbus. |
*.rdf |
True / False |
True |
Apache Parquet |
Formato de archivo de datos orientado a columnas desarrollado para el almacenamiento y la recuperación eficaces de datos. |
*.parquet |
True |
True |
ASAM COMMON MDF4 |
Formato de archivo binario para registrar datos de medición, publicado por la Association for Standardisation of Automation and Measuring Systems (ASAM). |
*.mf4 |
True / False |
True / False |
AstroNova Daxus Data Capture |
Formato de los sistemas de adquisición de datos Daxus de AstroNova. |
*.dcr;*.scr |
True / False |
True |
AVL iFile |
Formato de archivo binario de AVL, utilizado para análisis de combustión. |
*.* |
False |
True |
Bosch MDF |
Measurement Data Format, utilizado, por ejemplo, por el software INCA de ETAS. |
*.mdf;*.dat |
True / False |
True / False |
Data Translation HPF |
Formato High Performance File de Data Translation. |
*.hpf |
True / False |
True / False |
Dolphin ProfiSignal |
Formato de archivo ProfiSignal HDS de Delphin. |
*.hds |
True / False |
True |
DEWESoft D7D/DXD |
DEWESoft 7 y formato X de DEWESoft. |
*.d7d;*.dxd |
True / False |
True |
DEWETRON DMD |
Formato DEWETRON Measurement Data de Dewetron. |
*.dmd |
True / False |
True |
European Data Format EDF |
El European Data Format se utiliza para el intercambio y almacenamiento de bioseñales y otros datos de series temporales biológicas. |
*.edf |
True / False |
True |
FDSN miniSEED |
Formato de archivo de la International Federation of Digital Seismograph Networks (FDSN) para datos digitales e información relacionada. El objetivo principal es la recopilación, el archivo y el intercambio de datos sismológicos. |
*.mseed;*.mseed2;*.mseed3 |
True / False |
True |
Gantner Q.brixx |
Interfaz de importación para los sistemas de medición Q.brixx de Gantner. Debe crearse un archivo de texto con la extensión .qbrixx que contenga la dirección IP del sistema de medición. |
*.qbrixx |
True / False |
True |
Gantner UDBF |
Formato de archivo Universal Data Bin File de Gantner Instruments. |
*.dat |
True / False |
True / False |
GPS Exchange Format GPX |
GPS Exchange Format GPX de Topografix, para el intercambio de datos GPS. |
*.gpx |
True / False |
True |
Graphtec WR |
Archivos de grabadoras Graphtec de la serie GL/WR. |
*.dat;*.lmd;*.gdb |
True / False |
True |
HBM catman |
Formato de archivo utilizado por el software de adquisición de datos catman de HBM. |
*.bin;*.tst |
True / False |
True / False |
HBM MGCplus MEA |
Sistema de adquisición de datos de medición MGCplus de HBM. |
*.me* |
False |
True |
HBM nSoft Time Series |
Formato nSoft Time Series de HBM. |
*.dac |
False |
True / False |
HBM PNRF |
Formato de archivo PNRF de HBM; formato de archivo Nicolet/Odyssey/Vision NRF. |
*.pnrf;*.nrf |
True / False |
True |
HBM SoMat SIE |
Formato de archivo SoMat SIE de HBM. |
*.sie |
True / False |
True |
HDF Group HDF5 |
Hierarchical Data Format de HDF Group. |
*.h5 |
False |
False |
Head Acoustics HDF |
HEAD acoustics Datafile Format de HEAD acoustics. |
*.hdf |
True / False |
True |
HIOKI HiCORDER |
Grabadora HiCORDER serie 8835, 8835-01, 8826, 8841, 8842, 8807-01, 8808-01, 8855, 8860 y 8861. |
*.mem;*rec;*.fft;*.rms |
True / False |
True |
HP SDF |
Standard Data Format de Hewlett Packard. |
*.sdf;*.* |
False |
True |
HYDAC herf4 |
Formato de archivo HYDAC para los dispositivos HMG 4000. Los dispositivos HMG 2500, HMG 3000 y HMG 3010 son compatibles para la transmisión con HMGWin. |
*.herf4 |
True / False |
True |
IEEE PQDIF |
El Power Quality Data Interchange Format es un formato de archivo binario que se especifica en la norma IEEE 1159.3 y se utiliza para intercambiar valores de medición de tensión, corriente, potencia y energía entre aplicaciones de software. |
*.pqd |
True / False |
True / False |
IMC FAMOS |
Formato de archivo FAMOS de IMC. |
*.dat;*.* |
True / False |
True / False |
IMC imc |
Formato de archivo imc de IMC. |
*.dat;*.raw;*.dbc |
True / False |
True / False |
JSON |
JavaScript Object Notation es un formato de datos compacto en forma de texto fácil de leer para el intercambio de datos entre aplicaciones. |
*.json;*.jsn |
False |
False |
Kistler Open File |
Formato de archivo open de Kistler. |
*.open |
False |
True |
LeCroy WaveJet |
Formato de archivo waveform de los osciloscopios de la serie Wavejet. |
*.wfm |
True / False |
True |
Mathworks MATLAB |
Los archivos MAT son archivos binarios de MATLAB que almacenan variables del espacio de trabajo. |
*.mat |
false |
false |
MSR Electronics MSR3 |
Formato de datos de los registradores de datos MSR de MSR Electronics. |
*.msrprj;*.msr3 |
True / False |
True |
National Instruments DASYLab |
Formato de archivo DASYLab de National Instruments. |
*.ddf |
True / False |
True |
National Instruments TDM |
Formato de archivo National Instruments TDM; formato de archivo National Instruments Streaming TDMS. La importación de TDMS no admite el formato de tiempo. |
*.tdm;*.tdms |
True / False |
True / False |
NMEA 0183 |
Norma 0183 de la National Marine Electronics Association. |
*.nmea;*.* |
True / False |
True |
OROS OXF |
Formato de archivo NVGate OXF de OROS. |
*.oxf |
False |
True |
Parker Hannifin SMC |
Formato de archivo de Parker Hannifin. Se pueden leer archivos de medición originales (*.scco) y archivos de medición modificados con el software de comunicación (*.sccm). |
*.scco;*.sccm;*.scmo |
True / False |
True |
RION WAV |
Formato de archivo de RION Co, Ltd, utilizado, por ejemplo, por DA-21 Recorder. |
*.wav |
True / False |
True |
SEFRAM Recorder |
Formato de datos de SEFRAM Recorder. |
*.rec |
True / False |
True |
SYSCOM Instruments XMR/BMR |
Formato de datos de SYSCOM Instruments, por ejemplo, utilizado por las series MR3000 y MR2002 Recorder. |
*.xmr;*.bmr |
True / False |
True |
TiePie TPS |
Formato de archivo Multichannel TPS de TiePie. |
*.tps |
False |
True |
Unidata NetCDF |
Network Common Data Form, publicado por 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) y ASCII Logging File Format (.asc) de Vector. |
*.blf*;*.asc |
True / False |
True |
Yokogawa DXAdvanced |
Formato DXAdvanced de Yokogawa. |
*.dad;*.dae |
True / False |
True |
Yokogawa MX100 |
Formato MX100 de Yokogawa. |
*.mxd |
True / False |
True / False |
Yokogawa SmartDAC |
Formato SmartDAC de Yokogawa. |
*.gev;*.gds |
True / False |
True |
Yokogawa WDF/WVF |
Formato WDF y WVF de Yokogawa. |
*.wdf;*.wvf |
True / False |
True |
Disponibilidad
FlexPro View, Basic, Professional, Developer Suite
Ejemplos
ReadDataFile("c:\\examples\\file.dat", "IMC FAMOS", 1, FALSE, FALSE) |
Importa el primer canal desde un archivo FAMOS. |