historical_location_etl¶
Procesa datos climáticos históricos de estaciones meteorológicas y fuentes específicas por ubicación.
Gestión de Datos¶
El módulo data_managment/ maneja la ingesta y persistencia de datos:
| Componente | Descripción |
|---|---|
| csv_client.py | Lee observaciones de estaciones desde archivos CSV |
| data_validator.py | Valida la integridad de los datos, verifica rangos y completitud |
| database_manager.py | Maneja operaciones de base de datos (lectura/escritura) usando servicios ORM |
| geoserver_client.py | Sube datos procesados a GeoServer para visualización espacial |
Procesamiento Climático¶
El módulo climate_processing/ maneja la transformación de datos:
| Componente | Descripción |
|---|---|
| data_aggregator.py | Agrega datos diarios de estaciones a valores mensuales y anuales |
| climatology_calculator.py | Calcula las normales climatológicas de largo plazo por estación |
| indicators_processor.py | Orquesta el cálculo de indicadores puntuales por país |
Indicadores Puntuales¶
Se calculan con el mismo patrón de CalculatorLoader basado en plugins. Actualmente soporta 4 indicadores para datos a nivel de estación:
| Código | Indicador | Descripción |
|---|---|---|
| CANIC | Canícula | Detección de períodos de sequía intra-estival. Identifica períodos secos dentro de la temporada lluviosa que pueden afectar el desarrollo de los cultivos. |
| IELL | Índice de Estrés Hídrico | Índice de estrés hídrico. Evalúa el exceso o déficit de precipitación en relación con los requerimientos hídricos de los cultivos. |
| IELS | Índice de Estrés Hídrico Simplificado | Índice de estrés hídrico simplificado. Versión simplificada para evaluación rápida. |
| PRCD | Precipitación Acumulada | Precipitación acumulada. Lluvia total durante un período definido para el análisis del balance hídrico de cultivos. |
Los indicadores se configuran por país a través del modelo ORM MngCountryIndicator. Cada indicador tiene criterios asociados (por ejemplo, temporalidad) almacenados en la base de datos.
Herramientas¶
| Herramienta | Descripción |
|---|---|
| logging_manager | Registro centralizado con seguimiento de componentes y errores |
| tools.py | Funciones de utilidad generales |
Repositorio¶
Para instrucciones de instalación, consultar el README del repositorio: github.com/CIAT-DAPA/aclimate_v3_historical_location_etl