Cálculo de ICA diario a partir de ICA horario (CARM)

January 11, 2026 · View on GitHub

Este repositorio contiene el código y los datos que usamos en MurciaLab para convertir el Índice de Calidad del Aire (ICA) horario publicado por la Comunidad Autónoma de la Región de Murcia (CARM) en un ICA diario, de forma reproducible, auditable y transparente.

La idea es sencilla:
Si la administración publica el ICA por horas, es posible construir un resumen diario coherente que permita analizar el comportamiento anual del aire (por ejemplo, cuántos días fueron “desfavorables” o peores).

Estructura del repositorio

ICA_DIARIO_2025_SANBASILIO/
├── data/
│   └── e_sanbasilio_san_basilio_2025.json
│
├── src/
│   └── compute_daily_ica.py
│
├── output/
│   └── daily_ica_2025_sanbasilio.csv
│
├── docs/
│   └── METODOLOGIA_TECNICA.md
│
├── README.md
├── LICENSE
└── CITATION.cff

Qué hace este script

A partir de un archivo JSON con datos horarios oficiales:

  1. Lee el ICA horario oficial publicado por la CARM.
  2. Convierte las etiquetas de texto a niveles numéricos (1–6).
  3. Calcula el ICA diario tomando el máximo diario por contaminante y del valor GLOBAL.
  4. Determina el contaminante dominante del día.
  5. Genera un CSV final con una fila por día.

Qué NO hace (muy importante)

  • No genera datos horarios.
  • No recalcula concentraciones en µg/m³.
  • No aplica medias móviles.
  • Trabaja exclusivamente con categorías ICA oficiales ya calculadas.

MurciaLab actúa como agregador y analista, no como productor de datos primarios.

Entrada / salida

Entrada

Archivo JSON horario oficial:

  • data/e_sanbasilio_san_basilio_2025.json

Salida

Archivo CSV diario:

  • output/daily_ica_2025_sanbasilio.csv

Categorías del ICA utilizadas

NivelEtiqueta
1Buena
2Razonablemente buena
3Regular
4Desfavorable
5Muy desfavorable
6Extremadamente desfavorable

Sobre los breakpoints (BP)

Los breakpoints se utilizan únicamente como criterio técnico de desempate para identificar el contaminante dominante. No se recalculan categorías ni se alteran los criterios oficiales.

Metodología detallada

Consulta:

  • docs/METODOLOGIA_TECNICA.md

Licencia y citación

  • Ver LICENSE
  • Ver CITATION.cff