Saltar navegación

Documentación de FlexPro 2025

ReadDataFile

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:

Constante

Significado

READDATAFILE_DR_COMPLETE

El rango de datos se lee por completo.

READDATAFILE_DR_FROMTO

Se lee el rango de datos de RangeFrom a RangeTo.

READDATAFILE_DR_FROMDURATION

Se lee el rango de datos de RangeFrom a RangeFrom + Duration.

READDATAFILE_DR_DURATIONLAST

Se lee el rango de datos con la duración Duration hasta el último valor.

READDATAFILE_DR_FIRSTDURATION

Se lee el rango de datos con la duración Duration desde el primer valor.

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.

Véase también

Importación de datos

Asistente para la importación de archivos de datos