Variables de Análisis¶

Núcleo semántico del sistema¶

El módulo Variables de Análisis define los parámetros fundamentales que utiliza para representar, procesar y analizar la calidad del agua.

Estas variables constituyen un elemento estructural del sistema, ya que son utilizadas de forma transversal en:

• El procesado automático de datos satelitales.
• La generación de datasets temporales.
• El visor de mapas (básico y avanzado).
• La suscripción y configuración de alertas por variable.
• La importación de datos de muestreo.
• La generación de informes automáticos y personalizados.
• Las formulaciones y variables derivadas.

Por este motivo, la gestión de este módulo está restringida a usuarios administradores o técnicos autorizados.

🔐 Permisos necesarios¶

Para crear, editar o eliminar variables de análisis, el usuario debe disponer del permiso:

• Analysis parameter management

o bien

• Rol de Administrador del sistema.

Los usuarios sin este permiso:

• pueden visualizar el listado de variables,
• pero no pueden modificar su configuración.

Este control es esencial, ya que cualquier cambio afecta al comportamiento global del sistema.

Rol de las variables en la arquitectura¶

Cada variable de análisis actúa como un identificador común que conecta distintos subsistemas:

👉 Si una variable no está correctamente definida aquí, no existirá funcionalmente en el sistema.

Vista general del listado de variables¶

La pantalla principal muestra todas las variables registradas, indicando:

• ID: identificador interno.
• Nombre: etiqueta descriptiva visible para el usuario.
• Alias: identificador técnico.
• Unidades: unidad de representación.
• Acciones: edición o eliminación (según permisos).

Este listado permite verificar rápidamente:

• qué parámetros están disponibles,
• con qué nombre se visualizan,
• y cómo se identifican internamente.

Creación y edición de variables¶

Al crear o editar una variable, el administrador debe completar un formulario técnico con campos clave.

Nombre *¶

Nombre descriptivo y legible de la variable.

Aparece en:

• visores,
• gráficas,
• informes,
• ventanas emergentes.

Ejemplo:

sdd

⚠️ Campo crítico
Un alias incorrecto provoca que:

• la variable no se muestre en el visor avanzado,
• no se puedan generar alertas,
• no se utilice en informes,
• no se vincule con imágenes satelitales.

Por este motivo, el alias debe definirse en coordinación con el sistema de procesado y formulación.

Unidades¶

Define la unidad de medida con la que se expresa la variable.

Las unidades se utilizan en:

• gráficas,
• leyendas,
• informes,
• exportaciones.

Ejemplos habituales:

• m
• µg/L
• mg/L
• ppb
• °C

Modificar las unidades no afecta al cálculo, solo a la representación.

Keywords (palabras clave)¶

Las keywords permiten vincular automáticamente los datos de muestreo importados (Excel) con la variable correcta.

Funcionan como un puente semántico entre:

• el nombre del parámetro en el Excel,
• y la variable del sistema.

Ejemplo:

sdd
TRANSPARENCIA IN SITU
SECCHI

Si el valor de la columna NOMBRE del Excel coincide con una keyword:

• el dato se asocia automáticamente a la variable,
• se registra como muestreo válido.

Si no coincide:

• el dato se ignora durante la importación.

Ejemplo de variable correctamente configurada¶

Variables estándar¶

El sistema incorpora, entre otras, las siguientes variables base:

• Profundidad del disco Secchi (sdd)
• Clorofila-a (chla)
• Ficocianina (pc)
• Sólidos en suspensión (tss)
• CDOM (cdom)
• Temperatura superficial del agua (tsm)

Estas variables:

• alimentan los visores,
• activan alertas,
• y estructuran los informes.

Consideraciones técnicas importantes¶

• Cambiar un alias afecta a:
  • datasets,
  • alertas,
  • informes,
  • formulaciones.
• Cambiar una keyword afecta solo a la importación de muestreos.
• El nombre y las unidades son seguros de modificar.
• Las variables deben mantenerse alineadas con el procesado automático.

Buenas prácticas de gestión¶

• Definir variables antes de importar datos o generar alertas.
• Usar alias:
  • cortos,
  • en minúsculas,
  • sin espacios.
• Mantener una lista consensuada de keywords.
• Centralizar la gestión en personal técnico del sistema.
• Documentar cualquier cambio estructural.