Contáctanos
    Spanish

    Other Articles in This Category

    Subir lecturas en un archivo .CSV

    Cuando añades lecturas a tu red, puedes evaluar su rendimiento comparando los resultados de la simulación con datos históricos. En este artículo, te enseñaremos a añadir lecturas fácilmente desde un archivo .CSV.

    Prepara tus archivos para subirlos

    Lo primero es tener al menos una red cargada en Qatium. Después, para añadir lecturas a tus redes necesitas preparar:

    • Un archivo .CSV con los datos de las lecturas
    • Un archivo de asignación de señales en formato .CSV para mapear tus lecturas con los activos correspondientes 

    Si aún no tienes una red cargada en Qatium, aprende cómo hacerlo leyendo los artículos de esta sección.

    Archivo .CSV de lecturas

    Tus archivos de lecturas .CSV deben tener una estructura específica para que Qatium pueda interpretarlos correctamente. Prepare tu archivo siguiendo las especificaciones de la siguiente tabla.

    Etiqueta de la columna time  asset  metric unit value
    Tipo de dato

    <cadena>

    YYYY-MM-DD  HH:MM:SS

    		 <cadena>
    ID señal    		 <cadena> <cadena> <número>

    Para que las lecturas se asignen correctamente a los activos de tu red, escribe el ID de la señal en la columna "asset".

    Las columnas de datos pueden estar en cualquier orden, pero deben tener exactamente las mismas etiquetas que se muestran en la tabla. Debes escribirlas en inglés. Por ejemplo, puedes enviar cualquiera de las dos versiones siguientes y esperar el mismo resultado en Qatium:

    "time","asset","metric","value","unit"

    "2024-01-01 00:00:00","ScadaFeed#1","flow","1.723","l/s"

    "2024-01-01 00:00:00","ScadaFeed#2","pressure","66.105","m"

    OR

    "asset","metric","value","unit","time"

    "ScadaFeed#1","flow","1.723","l/s","2024-01-01 00:00:00"

    "ScadaFeed#2","pressure","66.105","m","2024-01-01 00:00:00"

    💡 Tip de Q: Descarga el ejemplo de archivo CSV para ver una demostración de los datos que debes incluir.

     
     
     

    Archivo .CSV de asignación de señales

    Para asignar tus señales (como SCADA o AMI), a tus activos de red en Qatium, prepara otro archivo .CSV aparte que incluya la siguiente información:

    • "signalId": Un identificador único para la señal externa.
    • "assetId": El identificador del activo de tu red al que deseas asignar la señal.
    • "assetProperty": La propiedad del activo a la que se está asignando (por ejemplo, caudal, presión).

    Por ejemplo:

    "signalId","assetId","assetProperty"

    "ScadaFeed#1","Pipe#1","flow"

    "ScadaFeed#2","J_07293","pressure"

    Estas son las propiedades que puedes establecer para cada activo. Asegúrate de escribirlas en inglés como aparecen en la siguiente tabla.

    Activo Propiedad
    Depósito level
    Nudo demand, pressure
    Tubería flow, status
    Bomba status, setting, upstreamPressure, downstreamPressure
    Válvula status, setting, upstreamPressure, downstreamPressure

    Si ya tienes lecturas cargadas en Qatium, y sólo necesitas mapear las señales, sigue estos pasos:

    1. Abre tu archivo .CSV de lecturas y reemplaza el ID del activo en la columna "asset" 
      por el ID de la señal.

    Por ejemplo, si tienes un archivo de lecturas con esta estructura:

    "time","asset","metric","value","unit"

    "2024-01-01 00:00:00","Pipe#1","flow","1.723","l/s"

    Edítalo para sustituir el ID del activo con el ID de la señal:

    "time","asset","metric","value","unit"

    "2024-01-01 00:00:00","ScadaFeed#1","flow","1.723","l/s"
    1. Sube de nuevo el archivo de lecturas para reemplazar el existente.
    2. Después, sube el archivo de asignación de señales que has creado.
     
     

    Conversión de unidades (opcional)

    Para convertir las unidades de los valores de las lecturas de tus sensores, añade una columna con "valueFactor" a tu archivo .CSV. El valueFactor es un multiplicador que te permite convertir los valores en las unidades deseadas.

    Por ejemplo:

    signalId,assetId,assetProperty,valueFactor

    "PressureSensor#1","Hydrant#1","pressure",10.199773339984

    Si tu sensor captura la presión en bares pero tu red utiliza metros, el factor de valor sería 10,2.

    ⚠️ Importante: El "valueFactor" sólo acepta valores numéricos y puntos decimales. Cualquier otro carácter será ignorado.

     
     
     

    Proceso de subida

    Cuando tus archivos .CSV estén listos, sólo tienes que arrastrarlos y soltarlos en la red uno a uno, y Q te informará al instante del resultado de la carga. Actualiza el navegador y la red reflejará tus datos inmediatamente. 

    ⚠️ Importante: Recuerda que Qatium sólo acepta un archivo de asignación de señales por red. Si necesita actualizar las asignaciones, carga un nuevo archivo de mapeo de señales para sobrescribir el existente.