Formatos de archivo CSV

Obtenga más información sobre los archivos de variables separadas por comas (CSV) utilizados en la importación, exportación o actualización de redes y conjuntos de datos de control.

Se incluyen las siguientes secciones

  1. Información general sobre el formato de los archivos
  2. Detalles de formato para tipos de campo específicos
  3. Uso de datos exportados de InfoWorks WS Pro

Información general sobre el formato de los archivos

La forma en que se distribuyen los datos entre archivos es bastante flexible:

Cada archivo consta de una combinación de:

Cada archivo se trata como una entidad individual. El delimitador de tipo de datos y la información de registro de encabezamiento no se transfieren de un archivo a otro.

Delimitador de tipo de datos

El delimitador de tipo de datos adopta la forma de cuatro estrellas seguidas del nombre de la tabla de base de datos que contiene detalles de este tipo de objeto de red.

Puede encontrar información sobre los nombres de las tablas de base de datos en la sección Campos de datos de red.

Ejemplo:

**** wn_node

El delimitador de encabezamiento se puede omitir y el nombre de archivo se puede utilizar para indicar el tipo de objeto, añadiendo el nombre de tabla menos el wn_to inicial al nombre de archivo.

Ejemplo:

xxx_node.csv indica a InfoWorks WS Pro que el archivo comienza con los datos de nodo.

El uso del nombre de archivo es una forma más visible de organizar los datos si dispone de un tipo de objeto de red por archivo. Este enfoque se utiliza al exportar desde InfoWorks WS Pro mediante la opción Exportar cada tabla a un archivo diferente.

Se puede utilizar un nombre de archivo para definir el tipo de datos al principio de un archivo y delimitadores de tipo de datos para definir diferentes tipos más adelante en el archivo. Sin embargo, es poco probable que este enfoque sea de gran beneficio.

Suprime el delimitador

El delimitador ****deletes se puede utilizar para definir una lista de objetos que se suprimirán al actualizar una red. El delimitador va seguido de un registro para cada objeto que se va a suprimir, que contiene el nombre de la tabla y el ID de activo del objeto.

Ejemplo:

****deletes
ObjectTable, asset_id
wn_pipe, 28165073
wn_pipe, 28165094
wn_node, 10857075
wn_node, 10857076

También puede añadir "deletes" al nombre de archivo para suprimir todos los objetos de un archivo.

Nota:

Registro de encabezado

El registro de encabezado contiene una lista de los nombres de campo contenidos en la tabla de base de datos del objeto de red.

Para InfoWorks WS Pro, los campos de clave principal son los siguientes:

Tablas de nodos (Nodo, Nodo de transferencia, Nodo de altura piezométrica fija, Hidrante, Depósito, Pozo) La clave principal para los nodos es el campo node_id. Este campo contiene una cadena de hasta 30 caracteres. El ID debe ser único en la red.
Tablas de vínculos (Tubería, Válvula, Válvula de flotador, Medidor, Válvula antirretorno, Estación de bombeo) Los vínculos requieren tres campos: upstream_node_id, downstream_node_id y link_suffix. La combinación de los tres campos debe ser única dentro de la red.
Tablas de curvas (Curvas de bomba, Curvas PRD, Curvas de válvula) La clave principal para las curvas de la bomba es el campo del ID. Este campo contiene una cadena de hasta 30 caracteres. El ID debe ser único en la red.

Las tablas de datos de control forman un patrón similar a las tablas de red. Hay una tabla de control para cada tabla de nodos y vínculos de la red. (No existe una tabla de control para la tabla de wn_pump, ya que las bombas forman parte de las estaciones de bombeo y las reglas de control se implementan a nivel de estación de bombeo).

Todos los registros de los datos de control están asociados a un nodo o vínculo de una red. Por este motivo, los campos de clave principal coinciden. Para que la simulación continúe, debe existir en la red el nodo o la tubería asociados descritos en la clave principal de Datos de control.

Registros de datos

El registro de encabezado va seguido de cero o más registros de datos.

Secuencias de escape

En determinadas circunstancias, es necesario utilizar secuencias de escape para mantener la estructura de los datos exportados.

Detalles de formato para tipos de campo específicos

Campos de texto

Los campos de texto deben estar entre comillas dobles si contienen comas u otras comillas dobles. De lo contrario, las comillas son opcionales.

Matrices de valores de un solo tipo

Las matrices de valores de un único tipo, como las coordenadas, pueden definirse en paquete (como un único campo) o por separado (cada valor se define en un campo independiente).

En paquete

>La matriz se define en un único campo que consta de una llave de abertura, seguida de una lista de valores separados por comas y una llave de cierre.

Ejemplo: matriz que define codos en una tubería

{389956.,110970.,389997.,111017.,390146.,110934.,390661.,111197.}
{389956.,110970.,389923.,111048.,390117.,111259.,390309.,111765.}

Por separado

La matriz se define con cada valor en un campo independiente con encabezados de columna para el primero de cada tipo de valor.

Ejemplo:

xs
ys

389956
110970
389997
111017
390146
110934
390661
111197
389956
110970
389923
111048
390117
111259
390309
111795

Matrices de valores que contienen más de un campo

Estas matrices contienen listas de valores que describen partes más complejas de objetos concretos, por ejemplo:

Las matrices pueden definirse en paquete (como un único campo) o por separado (en un bloque o archivo independiente).

En paquete

Cada matriz se define en un solo campo:

Ejemplo - Demanda de nodo:

Este ejemplo define la demanda en un nodo. Dos subcampos definen la demanda en una categoría de demanda:

{{Tourism,,10.000000,0},{DomSumer,,13.300000,0}}

Cada subcampo contiene 4 valores, que deben aparecer en el orden correcto. En este caso, el orden es:

Por separado

Cada matriz se define en un bloque o en un archivo independiente. Cada valor de la matriz se define en un campo independiente.

El delimitador de tipo de datos adopta la forma de cuatro asteriscos seguidos del nombre de la estructura de datos de la base de datos.

Puede encontrar detalles de los nombres de la estructura de datos de la base de datos en la sección Campos de datos de red.

Ejemplo- Curva de bomba

****wn_pump_triplets
 
 
 
id
flow
head
power
BPu-300
0
61.1
89.5
 
150
58
133
 
240
54.1
164.8
 
300
50
183.8
HP-200
0
48.5
46.7
 
100
46.2
70.5
 
200
40
98
 
300
22.3
117.5

Uso de datos exportados de InfoWorks WS Pro

Cuando se exportan archivos CSV desde InfoWorks WS Pro, puede exportar nombres de campo descriptivos e información de unidades. Se exportan como registros adicionales colocados antes de los registros de datos. Si exporta archivos que incluyen estos registros adicionales y, a continuación, intenta importarlos, InfoWorks WS Pro intentará interpretar los datos adicionales como registros de datos normales. Es muy probable que reciba un mensaje de error que indica que los valores del archivo tienen un tamaño o tipo incorrecto.

Hay otras opciones de exportación que le facilitarán la visualización de los datos de InfoWorks WS Pro en otros paquetes. Debe asegurarse de que los datos que va a importar de nuevo a InfoWorks WS Pro se exportan sin estos registros adicionales. El cuadro de diálogo Seleccionar opciones de exportación a CSV divide las opciones necesarias para la reimportación de las opciones adicionales y no debería tener problemas para exportar en el formato correcto. Los registros adicionales también se pueden eliminar editando el archivo en otro paquete antes de volver a importar.

Las secciones recortadas de la red no se exportan a archivos CSV. Un objeto de poda es muy complejo, ya que contiene detalles de todos los vínculos y nodos podados, así como información sobre la conectividad.