Saltar navegación

Documentación de FlexPro 2025

Objeto de datos

Objeto de datos es el término que engloba los conjuntos de datos, las fórmulas, los objetos de análisis y los objetos de vínculo de datos, es decir, todos los objetos que contienen datos o los proporcionan como resultado de un cálculo. Cada carpeta de la base de datos del proyecto es también un objeto de datos, ya que representa los conjuntos de datos almacenados en ella como lista. Todos los objetos de datos, excepto los conjuntos de datos, se basan en código FPScript. Usted puede utilizar estos objetos de datos como conjuntos de datos y visualizarlos en forma de diagrama o tabla, por ejemplo. El resultado puede tener una de las estructuras de datos y uno de los tipos de datos admitidos por FPScript. Puede convertir todos los objetos de datos basados en FPScript en conjuntos de datos en cualquier momento. A continuación, se calcula por última vez la fórmula FPScript contenida y se sustituye por su resultado.

Tipo de datos

FlexPro es capaz de gestionar y procesar los datos de forma que la memoria necesaria se adapte de forma óptima a la resolución de los datos. Esto resulta especialmente útil en el caso de grandes conjuntos de datos, teniendo en cuenta que las necesidades de memoria pueden multiplicarse hasta por cuatro en función del tipo de datos.

FlexPro lo consigue utilizando distintos tipos de datos, es decir, formatos de almacenamiento para números y textos. El sistema tiene cuatro tipos de datos numéricos básicos, cada uno de los cuales puede utilizarse para números reales y complejos, así como tipos de datos numéricos para tiempos de calendario e intervalos de tiempo. También existe un tipo de datos para cadenas y para valores booleanos y el tipo de datos Vacío, que corresponde a un resultado vacío.

La siguiente tabla ofrece una visión general.

Tipo de datos

Explicación

Notación en FPScript

Vacío

Variable no inicializada, resultado vacío o marcador de posición para un argumento de función.

Empty

<Identificador>

Valor booleano

Puede asumir el valor TRUE o FALSE.

TRUE, FALSE

Entero de 16 bits

Puede registrar números enteros en el intervalo de -32768 a +32767.

1234S, -1245S

Entero de 32 bits

Puede registrar números enteros en el intervalo de -2147483648 a +2147483647.

1234N, -1234N, 1000000N

Entero de 64 bits

Puede registrar números enteros en el intervalo de -9223372036854775808 a +9223372036854775807.

1234L, -1234L, 2147483648N

Número en coma flotante de 32 bits

Puede registrar números en coma flotante en el rango de -3.4e+38 a +3.4e+38.

1.23S, 1.45e-3S, ?S

Número en coma flotante de 64 bits

Puede registrar números en coma flotante en el rango de -1.7e+308 a +1.7e+308.

1.23, 1.45e-3, 1.23L, ?

Entero complejo de 16 bits

Puede registrar enteros complejos en el rango de -32768 a +32767.

(1234S, -1245S)

Entero complejo de 32 bits

Puede registrar enteros complejos en el rango de -2147483648 a +2147483647.

(1234N, -1234N)

Entero complejo de 64 bits

Puede registrar enteros complejos en el rango de -9223372036854775808 a +9223372036854775807.

(1234L, -1234L)

Número complejo en coma flotante de 32 bits

Puede registrar números complejos en coma flotante en el rango de -3.4e+38 a +3.4e+38.

(1.23S, 1.45e-3S)

Número complejo en coma flotante de 64 bits

Puede registrar números complejos en coma flotante en el rango de -1.7e+308 a +1.7e+308.

(1.23, 1.45e-3)

Tiempo de calendario

Puede registrar valores de fecha y hora. Los valores se almacenan como números en coma flotante de 64 bits que representan el número de segundos transcurridos desde el 1/1/1970 UTC (Tiempo Universal Coordinado). No se admiten valores de tiempo del calendario anteriores a esta fecha, es decir, el número en coma flotante subyacente al valor de tiempo del calendario no puede ser negativo.

FlexPro interpreta los valores de tiempo del calendario como una magnitud en la unidad implícita "segundos". Sin embargo, no aparece el símbolo de la unidad.

Para su visualización, los valores de tiempo del calendario se convierten a la zona horaria ajustada en Archivo > Opciones > Idioma y región.

Cualquier valor de tiempo del calendario introducido también se interpreta basado en esta zona horaria, a menos que especifique explícitamente la zona horaria al introducirlo. Esto se hace especificando el desfase horario respecto a UTC en horas y minutos.

Ejemplos en hora local:

'23.12.2024 12:23:30.1234'

'12/23/2024 12:23:30.1234'

'?/?/?'

(Los elementos de tiempo pueden omitirse desde la derecha y se interpretarán como 0)

 

Ejemplos con zona horaria:

'12/23/2024 12:23:30 UTC+2'

'12/23/2024 12:23:30 UTC+3:30'

'12/23/2024 12:23:30 UTC+3.5'

Intervalo de tiempo

Puede registrar intervalos de tiempo en los formatos DD:HH:MM:SS o HH:MM:SS. Los valores se guardan como números en coma flotante de 64 bits en la unidad "segundos".

FlexPro interpreta los intervalos de tiempo como una magnitud en la unidad implícita "segundos". Sin embargo, no aparece el símbolo de la unidad.

'12:23:30.1234'

'11:12:23:30.1234'

-'12:23:30' (intervalo de tiempo negativo)

'?:?:?'

Cadena

Puede grabar cadenas de hasta 2 GB de longitud.

"Esto es una cadena"

Referencia de objeto

Una referencia a cualquier objeto de Automation o FlexPro.

Set Object = Diagram.2d

Como puede verse en los ejemplos anteriores, FlexPro distingue entre números enteros y números en coma flotante mediante el punto decimal o añadiendo "N" o "n". La resolución puede especificarse añadiendo "S" o "L", o bien "s" o "l". "S" significa "short" (corto), es decir, número entero de 16 bits o número en coma flotante de 32 bits, y "L" significa "long" (largo), es decir, número entero de 64 bits o número en coma flotante de 64 bits. Si omite el sufijo, se utilizará automáticamente la resolución más alta para los números en coma flotante y una resolución de 32 o 64 bits para los enteros, en función del formato al que se ajuste la constante especificada. Por lo tanto, la "L" puede omitirse por regla general.

Nota El modo en que se interpretan los números decimales que no se han introducido ni con sufijo ni con punto decimal depende de la configuración Interpretar números decimales sin punto decimal como números en coma flotante en la pestaña General del cuadro de diálogo de propiedades de la base de datos del proyecto. La opción está activada por defecto, es decir, los números se interpretan como números en coma flotante de 64 bits. Este ajuste evita errores de redondeo accidentales que pueden producirse con la aritmética de enteros, por ejemplo, la división de enteros 1/2 devuelve como resultado 0 y no 0,5.

Cuando se calculan datos con diferentes formatos, FlexPro ajusta automáticamente los tipos de datos. El ajuste automático se realiza siempre de forma que no se pierda ninguna información. Al sumar un número entero a un número en coma flotante, por ejemplo, el número entero se convierte primero en un número en coma flotante y no al revés, ya que de lo contrario podrían perderse decimales. En el caso de los datos constantes que utiliza en las fórmulas, FlexPro reconoce el tipo de datos a partir de la notación. También tiene la opción de convertir explícitamente los tipos de datos utilizando un operador de conversión de tipo:

La FloatingPoint64 SeriesDeDatos       convierte todos los valores de una serie de datos en números en coma flotante de 64 bits, por ejemplo.

Las referencias de objetos solo pueden utilizarse de forma limitada. Aunque puede asignar una referencia de objeto a una variable local, no puede devolverla como resultado de una fórmula. Si una referencia de objeto se utiliza como valor de retorno de una fórmula o en un cálculo matemático, se convertirá a su valor. Si el objeto al que se refiere la referencia es un objeto de datos, por ejemplo, una fórmula, se utiliza su valor de retorno; para todos los demás objetos, el valor estará vacío.

Componente

Los conjuntos de datos pueden tener una estructura de datos compuesta, es decir, una estructura de datos formada por un máximo de tres componentes. Estos componentes se denominan componentes Y, X y Z. Las denominaciones corresponden a los nombres de los ejes de los diagramas 2D y 3D.

Una señal temporal simple consta, por ejemplo, de un componente Y, que contiene una serie de datos que incluye las tensiones, y un componente X, que contiene una serie de datos de la misma longitud que incluye los tiempos correspondientes. Un valor del componente Y y otro del componente X forman juntos un punto de una curva en el plano bidimensional de un diagrama 2D.

En la siguiente ilustración se observan las relaciones:

Dentro de las fórmulas, puede acceder a los componentes individuales del conjunto de datos por separado especificando el nombre del componente como extensión del nombre. Signal.Y toma el componente Y del conjunto de datos Signal, por ejemplo.

Estructura de datos

Los conjuntos de datos pueden tener diferentes estructuras de datos. La estructura de datos especifica cómo se organizan los datos en el conjunto de datos. Se distingue entre estructuras de datos simples y estructuras de datos compuestas. Las estructuras de datos compuestas se construyen a partir de las simples. La siguiente tabla ofrece una visión general de las estructuras de datos simples:

Estructura de datos

Contenido

Valor escalar

Un valor individual.

Serie de datos

Una matriz unidimensional de valores.

Matriz de datos

Un matriz bidimensional de valores. Las columnas pueden visualizarse como series de datos con el mismo número de valores.

Para las estructuras de datos simples se permiten todos los tipos de datos.

Las siguientes estructuras de datos compuestas se basan en las estructuras anteriores:

Estructura de datos

Contenido

Ejemplo de aplicación

Señal

Un componente Y y un componente X, cada uno con una serie de datos de la misma longitud.

Una señal de tiempo. El componente Y contiene la tensión y el componente X, el tiempo correspondiente.

Serie de señales

Un componente Y con una matriz de datos y un componente X con una serie de datos. La longitud de la serie de datos debe coincidir con el número de filas de la matriz de datos.

Una serie espectral. El componente Y contiene varios espectros de frecuencia y el componente X contiene los valores de frecuencia aplicables a todos los espectros.

Serie de señales con componente X bidimensional

Un componente Y y un componente X con una matriz de datos del mismo tamaño.

Una serie de señales de tiempo. El componente Y contiene las tensiones de las señales individuales y el componente X contiene los tiempos de calendario correspondientes.

Serie de señales con componente Z

Como la serie de señales, pero con un componente Z adicional cuyo número de valores debe corresponder al número de columnas de la matriz de datos Y.

Serie espectral en la que los tiempos a los que se determinaron los espectros se introducen en el componente Z.

Series de señales con componentes X y Z bidimensionales

Como la serie de señales con componente X bidimensional, pero con componente Z, cuyo número de valores debe corresponder al número de columnas de la matriz de datos Y.

Una serie de señales de tiempo. El componente Y contiene las tensiones de las señales individuales y el componente X contiene los tiempos en segundos. El componente Z contiene los tiempos de calendario en los que se midieron las señales.

Curva espacial

Un componente Y, un componente X y un componente Z, cada uno con una serie de datos de la misma longitud.

Una trayectoria en el espacio tridimensional. Magnitud medida en cualquier punto de una superficie.

Lista

Lista en la que cada elemento puede tener cualquier estructura de datos y, en particular, puede ser a su vez una lista. Los elementos de las listas también pueden contener referencias de objetos.

Una lista con varios conjuntos de datos, por ejemplo, el resultado de una consulta de datos.

Una estructura de datos compleja, por ejemplo, el resultado de una regresión, que contiene una serie de datos con los parámetros hallados, así como sus intervalos de confianza y la medida de ajuste de la regresión.

Para los componentes X y Z de las estructuras de datos compuestas se permiten todos los tipos de datos reales y los tipos tiempo de calendario e intervalo de tiempo. Los tipos de datos complejos y el tipo valor booleano también están permitidos para el componente Y. Las estructuras de datos compuestos de FlexPro simplifican especialmente el análisis en FlexPro, ya que los componentes X, Y y, si procede, Z pueden calcularse en una única fórmula. Una fórmula que calcule una transformada de Fourier, por ejemplo, puede convertir las amplitudes de la señal de tiempo en amplitudes espectrales y, simultáneamente, los valores temporales en valores frecuenciales sin necesidad de una segunda fórmula.

La estructura de datos Lista se utiliza, por ejemplo, para crear estructuras de datos complejas si las estructuras de datos admitidas por FlexPro no son adecuadas para registrar el resultado. Incluso si un método de cálculo proporciona varios resultados que no pueden calcularse independientemente unos de otros como fórmulas separadas, puede devolver los resultados como una lista. Las listas son la base del análisis multicanal con FlexPro. Muchos objetos de análisis, así como funciones y operadores de FPScript, admiten listas en el sentido de que se procesan elemento por elemento y el resultado es, a su vez, una lista.

Las listas tienen una posición especial, ya que solo se permiten como valores de retorno de fórmulas y no como estructura de datos de un conjunto de datos. En su lugar, una carpeta de la base de datos del proyecto representa los conjuntos de datos que contiene en forma de lista, en la que los conjuntos de datos de los componentes asignados entre sí se resumen en la lista para formar estructuras de datos compuestas. Al convertir en conjunto de datos una fórmula que devuelve una lista, se crea una carpeta en la que se insertan los elementos de la lista como conjuntos de datos.

Unidad de datos

Cada componente de un objeto de datos puede tener una unidad física y se convierte así en una magnitud física. La gestión de unidades es una parte integral de FPScript y en FPScript se puede calcular directamente con magnitudes físicas. FPScript procesa la unidad como un componente directo de los datos, puede convertir unidades, reconocer cálculos inválidos y determinar la unidad del resultado de un cálculo basándose en las unidades de los argumentos. Por ejemplo, el siguiente código FPScript proporciona una señal con una onda senoidal de 2 V de amplitud, 0.1 kHz de frecuencia y 1 ms de intervalo de muestreo:

// Valores de tiempo ascendentes en el intervalo [0 s, 10 s]

// e intervalo de muestreo de 1 ms

Dim t = Series(0 s, 10 s, 1 ms)

Signal(2 V * Sin(2 Pi * 0.1 kHz * t), t)

Alternativamente, la unidad también puede asignarse posteriormente a través de la información de cabecera del objeto de datos. A continuación se ofrecen más detalles.

Asignar objetos de datos

FlexPro normalmente guarda juntos todos los componentes de una estructura de datos compuesta en un solo conjunto de datos, por ejemplo, los valores de amplitud y de tiempo de una señal de tiempo. Esto también se aplica si varios conjuntos de datos tienen el mismo componente X, por ejemplo, si se están importando datos de una medición multicanal. Los valores de tiempo para los canales individuales suelen estar en orden lineal ascendente, de modo que FlexPro solo tiene que guardar internamente los parámetros valor de inicio, incremento y número de valores, en lugar de las columnas de números. Sin embargo, hay casos en los que los valores X deben guardarse explícitamente, por ejemplo, cuando la frecuencia de muestreo ha variado durante la medición. En ese caso, guardar los mismos valores X en cada conjunto de datos sería ineficaz. Por lo tanto, FlexPro admite otra opción para gestionar estructuras de datos compuestas. Los valores Y y los valores X se almacenan en conjuntos de datos separados en forma de series de datos y estos conjuntos de datos se asignan entre sí.

Esta asignación se guarda en la información de cabecera del conjunto de datos y puede modificarse en la pestaña Componente y asignaciones del cuadro de diálogo de propiedades.

El conjunto de datos que contiene la serie de datos con los valores X se selecciona allí como componente X, y los conjuntos de datos que contienen los valores Y de los canales individuales de una medición se seleccionan correspondientemente como componente Y. Además, se introduce una referencia al conjunto de datos X en la información de cabecera de los conjuntos de datos Y.

Mediante la asignación, FlexPro siempre puede encontrar el conjunto de datos X correcto al crear un diagrama, por ejemplo. En la curva del diagrama, FlexPro activa entonces la opción Conjuntos de datos separados para componentes X e Y y también introduce el conjunto de datos X asignado en el conjunto de datos Y en la curva.

Esta asignación puede realizarse no solo para conjuntos de datos, sino para todos los objetos de datos, por ejemplo, las fórmulas. Sin embargo, la asignación no suele ser necesaria para las fórmulas, ya que el componente X puede incluirse en el resultado utilizando simplemente la función Signal.

Orden de datos

El orden de datos es una propiedad de una serie de datos que indica cómo se ordenan los valores en la serie de datos por tamaño. Se distinguen los siguientes órdenes de datos:

Denominación

Significado

Ninguno

Los valores del conjunto de datos no tienen un orden específico.

Constante

El conjunto de datos es un valor escalar o todos los valores del conjunto de datos son idénticos.

Ascendente

Cada valor del conjunto de datos es mayor o igual que su predecesor.

Lineal ascendente

La distancia entre valores vecinos es constante y mayor que cero.

Descendente

Cada valor del conjunto de datos es menor o igual que su predecesor.

Lineal descendente

La distancia entre valores vecinos es constante y menor que cero.

Una señal cuyo componente X aumenta linealmente también se denomina muestreada de forma equidistante. Esto es requerido por algunos algoritmos de análisis de datos, como FFT.

FlexPro muestra el orden de los datos de los componentes individuales de un objeto de datos en una ventana de información cuando se apunta al objeto en la lista de objetos.

Información de cabecera

La información de cabecera, también conocida como metadatos o cabecera, son atributos que se pueden asignar a un objeto de datos.

En el cuadro de diálogo de propiedades de un objeto de datos puede introducir lo siguiente (los cuatro primeros atributos se aplican a todos los objetos, no solo a los objetos de datos):

Comentario

Se trata de un comentario sobre el contenido del objeto. El comentario aparece junto con el nombre en la lista de objetos. Para los objetos de datos con una estructura de datos compuesta, puede introducir hasta tres comentarios. Uno para cada componente.

Hipervínculo

Es una referencia a un archivo externo, un sitio web, una dirección de correo electrónico u otro objeto de la base de datos del proyecto. El comando Seguir hipervínculo abre el objeto referenciado.

Fecha

Aquí se registran la fecha y la hora de creación del objeto.

Parámetros

Una lista de parámetros de libre edición en la que se puede guardar cualquier información adicional.

Los siguientes atributos son específicos de los objetos de datos:

Cálculos

Una lista de cálculos que proporcionan parámetros para el conjunto de datos. Normalmente se establecen los cálculos para la indexación de datos. El explorador de datos lo transfiere a la información de cabecera al importar un conjunto de datos.

Unidad

Es la unidad física de los componentes individuales del objeto de datos. La interpretación de la unidad en la información de cabecera depende de si el objeto de datos es un conjunto de datos, una fórmula o un objeto de análisis:

oLa unidad se asigna a los datos de un conjunto de datos sin transformación y estos se devuelven posteriormente como disponibles en esta unidad. En general, FlexPro siempre mantiene la unidad de datos de los conjuntos de datos sincronizada con la unidad de la información de cabecera.

oEn cambio, los datos de una fórmula o de un objeto de análisis se transforman antes de cada acceso a dicha unidad. Si el código FPScript devuelve un resultado sin unidad, la unidad introducida se asigna sin transformación. Si, por el contrario, devuelve un resultado con una unidad, esta se transforma a la unidad especificada. Si la unidad en la información de cabecera es incompatible con la unidad que proporciona el resultado de la fórmula FPScript, FlexPro emite un mensaje de error.

Nota Para transformar los datos de un conjunto de datos a una unidad diferente, utilice el comando Cambiar unidades o introduzca el símbolo de la nueva unidad en el campo Unidad de datos de la ventana de propiedades.

Tamaño

La designación de la magnitud física de los componentes individuales del objeto de datos.

Límites inferior y superior del rango de datos

Para los datos medidos, estos campos indican el rango de medición utilizado en la unidad física de los datos, por ejemplo de -5 V a +5 V. FlexPro puede utilizarlos para la autoescala de ejes. Los límites del rango de datos son opcionales; si no especifica ninguno, se utilizan en su lugar el mínimo y el máximo del conjunto de datos.

Marca de tiempo

FlexPro utiliza estos campos, si se especifican, para convertir datos de tiempo de tiempo relativo a tiempo absoluto y viceversa. La marca de tiempo es un valor de tiempo del calendario que se asigna al instante t = 0 en los datos de tiempo. Cuando se convierte a tiempo absoluto, se suma a todos los datos y, cuando se convierte a tiempo relativo, se resta.

Autor

El autor del objeto. Esto es especialmente interesante para los conjuntos de datos introducidos manualmente y para las fórmulas.

Origen

Descripción del origen del objeto de datos, por ejemplo, el nombre del punto de medición.

Conjuntos de datos asignados

Referencias a objetos de datos asignados que, junto con los datos de ese objeto, forman una estructura de datos compuesta (véase más arriba).

Formato, formato X, formato Z

Especifican cómo deben formatearse los datos del objeto de datos para su emisión.

Color

A cada conjunto de datos se le puede asignar un color al importar los datos, que luego tiene prioridad sobre el esquema de colores del diagrama cuando se visualiza como curva. Los colores se leen del archivo que se va a importar si están almacenados en él. Como resultado, las curvas en FlexPro se muestran en los mismos colores que en el dispositivo de medición.

Exportación de datos

FlexPro le ofrece la opción de exportar conjuntos de datos, fórmulas y objetos relacionados con ellos. Puede guardar los datos en los formatos de archivo FlexPro (.fpf), texto (.txt), CSV (.csv), archivo de audio (.wav) y en una variedad de formatos de archivo propietarios. CSV son las siglas de Comma Separated Values. En este formato, los valores se separan con el separador de listas especificado en el Panel de control de Windows en Región.

Al almacenar en formato CSV o de texto, tiene la opción de exportar varios objetos uno debajo de otro o uno junto a otro en un único archivo. Para estos formatos, también puede seleccionar diferentes formatos de archivo y especificar si se debe emitir el resultado o el código de fórmula para las fórmulas.

El formato FlexPro es similar a la variante del formato de texto, en la que los datos de varios conjuntos de datos se almacenan uno junto a otro y con toda la información de cabecera. Sin embargo, aquí también se emite una fila con un denominador de formato de datos. Además, los números en coma flotante siempre se emiten con un punto decimal, independientemente de la configuración del sistema. Los tiempos de calendario también se emiten siempre en el mismo formato, independientemente de la configuración del sistema.

Las señales y las series de señales con dos señales son adecuadas principalmente para la exportación como archivos de audio. Las señales se tratan como señales mono y las series de señales con dos señales, como señales estéreo. Las series de señales con más de dos canales se exportan como archivos de audio multicanal. El componente X de los datos debe corresponder a una de las frecuencias de muestreo 11025 Hz, 22050 Hz o 44100 Hz admitidas por el formato de archivo de audio.

Puede exportar los datos de fórmulas, conjuntos de datos y objetos relacionados como objetos OLE, y así insertar vínculos a dichos datos en aplicaciones cliente OLE. FlexPro ofrece los datos en formato CSV y de texto.

Véase también

Conjunto de datos

Fórmula

Objeto de análisis

Objeto de vínculo de datos

Trabajar con objetos de datos

Reproducir objetos de datos como archivos de audio

Editar la información de cabecera de un objeto de datos

Cambiar las unidades de los objetos de datos

Convertir fórmulas, objetos de análisis u objetos de vínculo de datos en conjuntos de datos

Convertir objetos de análisis o de vínculo de datos en fórmulas

Recopilar varios objetos de datos en una lista