Formato de archivo de datos de serie temporal

El formato de archivo de datos de serie temporal se ha desarrollado para proporcionar una forma flexible de almacenar grandes cantidades de datos de serie temporal de diferentes orígenes para poder importar los datos en InfoWorks.

Nota:

El formato es un proyecto en curso y está sujeto a cambios en el futuro. Por lo tanto, es esencial que se ponga en contacto con Autodesk antes de comenzar a utilizar el formato.

Contáctenos para:

En las secciones siguientes se describe el formato de los archivos de datos de serie temporal:

  1. Archivo TSD
  2. Archivo DAT

Las descripciones de formato son correctas en el momento de la emisión de este archivo de ayuda.

Archivo TSD

Los archivos TSD contienen una sección de encabezamiento seguida de una sección de datos. Todas las líneas que comiencen por un punto y coma son líneas de comentario y el lector de archivos las omitirá. A continuación, puede ver un ejemplo.

[TSD_VERSION=3.0]
[SYSTEM_TYPE=Radcom logger]
FO120716,FO12 STATION FLOW,Flow,m3/h,USED,0,500 
FO120717,FO12 BOREHOLE FLOW,Flow,m3/h,USED,0,500 

Sección de encabezamiento

El encabezado contiene parámetros varios y sus valores.

Cada línea tiene un parámetro (uno de un conjunto de tipos de parámetros enumerados) seguido de = y un valor (véase a continuación). Cada par parámetro-valor se encierra en un par de corchetes. En una línea solo puede haber un par parámetro-valor.

Sección de datos

Esta es la sección más importante del archivo TSD.

Consta de una serie de líneas separadas por comas que contienen los puntos de medida o las ubicaciones utilizadas en el sistema. Los campos separados por comas también contienen otra información importante, como el tipo de lectura y las unidades.

El primer campo de cada línea separada por comas es una clave única. Esta clave se utiliza para relacionar la información de los otros campos de la línea con los valores (las lecturas reales) de los archivos DAT.

Los valores contenidos en cada campo son, respectivamente:

Campo Descripción Formato Ejemplo

Clave

Identificador único utilizado para relacionar el resto de datos de la línea con los valores del archivo DAT

Cadena de 8 caracteres que contiene los caracteres [0-9] y [A-Z]

Tenga en cuenta lo siguiente:

  • Las comparaciones de claves no distinguen entre mayúsculas y minúsculas
  • Los espacios iniciales y finales se ignoran
FO120716

Ubicación

La ubicación de los valores

Cadena de cualquier combinación de caracteres alfanuméricos, excepto la coma y las comillas dobles

Tenga en cuenta lo siguiente:

  • Las comparaciones de todas las cadenas no distinguen entre mayúsculas y minúsculas
  • Los espacios iniciales y finales se ignoran
FO12 STATION FLOW

Tipo de datos

El tipo de medición

Uno de los tipos enumerados del conjunto Tipos de datos. (Consulte Tipos de datos y unidades a continuación).

Flow

Unidades

Las unidades de medida

Uno de los tipos enumerados del conjunto Unidades. (Consulte Tipos de datos y unidades a continuación).

m3/h

Estado

Campo reservado: Establezca el valor en USED

Tipo enumerado

USED

Valor mínimo válido

Los límites inferior y superior aceptables de los valores respectivamente. Estos campos opcionales se pueden utilizar para filtrar o marcar los valores incongruentes que aparecen en los archivos DAT. Por ejemplo, esto puede suceder si un instrumento se vuelve defectuoso. La forma en que se gestionen estos valores dependerá de la implementación específica del sistema que lea el archivo TSD

Número

  • Deje estos campos en blanco o espacios en blanco si no se utilizan
  • Punto flotante o entero
  • Firmado o no firmado
  • No utilizar exponentes, por ejemplo, 1,0234e-01
0

Valor máximo válido

500

Tipos y unidades de datos

Las unidades aceptables para los archivos de datos de serie temporal son:

Tipo de datos Unidades aceptables

CAUDAL

'l/d', 'l/hr', 'l/min', 'l/s', 'Litres per sec''Ml/d', 'Million litres per day'

'm3/h', 'm3/hr', 'm3/hour', 'cum/hr', 'm3/s', 'cfs'

PRESIÓN

'm', 'mHd', 'metre', 'Metres''cm', 'mm', 'mmH2O'

'bar', 'psi', 'ft', 'KPa'

PROFUNDIDAD

'm'

'cm'

'mm'

CONCENTRATION

'mg/l', 'microg/l'

'ppb', 'ppm'

PUMP_RUNNING

Ninguno

(Cualquier valor distinto de cero del archivo DAT se lee como ON)

PC_VOLUME

'% full'

(Los valores del archivo DAT se leen como porcentajes)

OPENING

'% open'

(Los valores del archivo DAT se leen como porcentajes de abertura)

Archivos DAT

Los archivos DAT son un conjunto de archivos marca de fecha que contienen varias secciones marca temporal. Cada sección contiene un conjunto de registros clave-valor-etiqueta. A continuación, puede ver un ejemplo.

_00:00
FO120716,238.0952, 1
FO120717,102.3199, 1
_00:21
FO120716,236.0195, 1
FO120717,102.3199, 2
FO120718,3.2451, 1
FO120719,2.2073, 1
_00:33
FO120716,236.3858, 1
FO120717,102.0757, 2
FO120718,3.2599, 1
FO120719,2.2073, 1

Los archivos DAT tienen una convención de nomenclatura específica que representa la fecha de los datos que contienen. El formato es:

AAAA-MM-DD.dat

donde:

AAAA es un año de 4 dígitos

MM es un mes de 2 dígitos (01 a 12)

DD es un día de 2 dígitos (01 a 31)

Los ceros a la izquierda son obligatorios. Los componentes de fecha deben estar separados por un signo menos.

Algunos ejemplos son:

dat

dat

Secciones y registros de etiqueta de clave-valor

Cada sección contiene una marca temporal y una serie de valores que se registran en este momento. Las secciones con marca temporal aparecen en orden cronológico ascendente. Cada valor aparece como un registro clave-valor-etiqueta. La clave se utiliza para relacionar el valor con los datos almacenados en el archivo TSD.

Fila Formato Ejemplos

Marca temporal

hh:mm

donde:

hh es una hora de 2 dígitos (de 00 a 23).

mm es un minuto de 2 dígitos (de 00 a 59).

Tenga en cuenta lo siguiente:

  • Los ceros a la izquierda son obligatorios
  • Los dos puntos deben separar los componentes de tiempo
  • El tiempo debe ir precedido por un guion bajo
_00:00

_00:21

Registros clave-valor-etiqueta

key,value,flag

donde:

key es una clave que aparece en el archivo TSD

value es el valor (véase la Nota 3 anterior)

flag es un campo entero opcional que se puede utilizar para etiquetar la fiabilidad o la calidad de los datos. Consulte el tema Etiquetas de datos activos para obtener más información sobre cómo mostrar la información de las etiquetas.

FO120716,238.0952, 1
FO120717,102.3199, 1