Catálogo de Fórmulas¶
Introducción¶
El módulo Catálogo de Fórmulas del sistema permite definir expresiones matemáticas utilizadas para calcular variables derivadas a partir de reflectancias o bandas satelitales.
Este catálogo permite:
- Consultar todas las fórmulas disponibles en el sistema.
- Gestionar fórmulas globales para el visor avanzado (aplicables a todos los embalses).
- Gestionar fórmulas por embalse para el visor avanzado (a un embalse particular).
- Definir o editar expresiones científicas publicadas en la literatura.
Las fórmulas son usadas por el visor avanzado para disoner de variables al vuelo o comparar diferentes expressiones al vuelo respecto a las variables definidas para cada embalse.
Listado del Catálogo¶
La tabla del catálogo muestra todas las fórmulas disponibles, con los siguientes campos:
Campos del listado¶
| Campo | Descripción |
|---|---|
| ID | Identificador único de la fórmula. |
| Nombre | Nombre interno de la fórmula (slug). |
| Título | Nombre visible o científico de la fórmula. |
| Expresión | Fórmula matemática utilizada para el cálculo. |
| Dataset | Dataset al que está asociada (ALL indica fórmula global). |
| Visible | Indica si la fórmula está disponible para selección y cálculo. |
| Acciones | Ver, editar o eliminar fórmula (según permisos). |
Ejemplos de fórmulas en el catálogo¶
A continuación se muestran ejemplos reales incluidos en el sistema:
| ID | Nombre | Título | Expresión | Dataset | Visible |
|---|---|---|---|---|---|
| 12 | tss_perivolioti_2024_calc |
TSS (Perivolioti et al., 2024) | -7.22 * (rhow_B4 / rhow_B3) - 221.36 * ((rhow_B3 - rhow_B8A) / (rhow_B3 + rhow_B8A)) + 229.05 * ((rhow_B4 / rhow_B3) * ((rhow_B3 - rhow_B8A) / (rhow_B3 + rhow_B8A))) + 77.94 |
ALL | ✔ |
| 11 | ndwi_perivolioti_2024_calc |
NDWI (Perivolioti et al., 2024) | (rhow_B3 - rhow_B8A) / (rhow_B3 + rhow_B8A) |
ALL | ✔ |
Estas fórmulas se basan en reflectancias corregidas atmosféricamente (rhow) y bandas Sentinel-2.
Crear o Editar Fórmula¶
El formulario de Crear o Editar Fórmula permite definir todas las propiedades necesarias para que una fórmula pueda ser utilizada por el sistema en cálculos, visores y procesamiento satelital.
Esta funcionalidad está disponible únicamente para usuarios con permisos de gestión avanzada.
Campos del formulario¶
| Campo | Ejemplo | Descripción |
|---|---|---|
| Dataset * | ALL | Dataset sobre el que se aplicará la fórmula. Si se selecciona ALL, la fórmula será global y podrá usarse en cualquier embalse o procesamiento. |
| ID Fórmula | usercalc_ALL_tss_perivolioti_2024_calc | Identificador interno generado por el sistema. Es único y no editable. |
| Nombre | tss_perivolioti_2024_calc | Nombre interno (slug) de la fórmula. Único, sin espacios. Se usa en la lógica interna del sistema. |
| Título | TSS (Perivolioti et al., 2024) | Nombre visible de la fórmula tal como se muestra en visores y listados. |
| Expresión * | -7.22 * (rhow_B4 / rhow_B3) - 221.36 * (...) |
Expresión matemática escrita en sintaxis Python/Numpy. Utiliza reflectancias o variables del dataset (rhow_B3, ds.rhow_B5, etc.). Obligatoria. |
| Unidades | mg/L | Unidades físicas del resultado de la fórmula (mg/L, m, RFU, IU, etc.). Se muestran en visores y gráficos. |
| Color Bar | Oranges | Paleta de colores para representar esta variable en el visor avanzado. Compatible con paletas Matplotlib. |
| Dtype | float64 | Tipo de dato del resultado (float32, float64, int, etc.). |
| Color Bar Norm | linear | Tipo de normalización del color: linear, log, etc. Controla la visualización del mapa. |
| Color Bar Min | 0 | Valor mínimo del rango de color para la visualización. |
| Color Bar Max | 60 | Valor máximo del rango de color para la visualización. |
| Opacidad | 1 | Opacidad del mapa cuando se visualiza esta variable (valor entre 0 y 1). |
| Shape (JSON) | Información de la forma de la matriz generada (solo en fórmulas avanzadas). Campo técnico. | |
| Dims (JSON) | Dimensiones de la salida. Solo se utiliza en cálculos complejos con múltiples dimensiones. | |
| Atributos (JSON) | Atributos adicionales asociados a la variable. Campo técnico reservado para integraciones futuras. | |
| Otros (JSON) | Metadatos adicionales no estructurados. Campo técnico. | |
| Visible | ✔ | Define si la fórmula estará disponible para selección y visualización en visores y listados. |
Validación de campos¶
Durante la creación o edición, el sistema valida:
- Que la expresión sea sintácticamente correcta.
- Que todas las bandas o variables utilizadas existan para el dataset seleccionado.
- Que los rangos de color sean coherentes (
Color Bar Min<Color Bar Max). - Que la fórmula no duplique el nombre de otra existente.
Si se detecta un error, el sistema mostrará un mensaje indicando el campo a corregir.
Guardado y efectos en el sistema¶
Al guardar los cambios:
- La fórmula será utilizada en nuevos cálculos y procesamientos satelitales.
- Si está marcada como Visible, podrá seleccionarse en el visor avanzado.
- Si el embalse no tiene fórmulas personalizadas para esa variable, se utilizará esta fórmula global.
- Las modificaciones no se aplican retroactivamente a procesamientos anteriores ya almacenados.
Por esta razón se recomienda:
- Mantener un registro interno o notas de las versiones modificadas.
- Cambiar los títulos o añadir sufijos si se reemplaza una fórmula previa.
Si quieres, puedo extender este módulo con:
- Crear nueva fórmula
- Eliminar fórmula
- Buenas prácticas científicas para fórmulas satelitales
- Relación entre fórmulas del catálogo y fórmulas por embalse