Aridkpi: climate-resilience KPIs for residential buildings in arid South American climates
Otros responsables
Fecha
Publicador:
Consejo Nacional de Investigaciones Científicas y Técnicas
Fecha de depósito:
12/08/2026
Fecha de creación:
02/05/2026
Clasificación temática
Resumen
aridkpi es una librería Python de código abierto que implementa los cinco indicadores clave de desempeño (KPIs) del núcleo definido en la KPI Comparison Matrix v1.0 (DOI: 10.5281/zenodo.19964373), para la evaluación de la resiliencia climática de edificios residenciales en climas áridos y semiáridos de Sudamérica (regiones BWk/BSk según Köppen-Geiger). Extiende el marco de indicadores del proyecto IEA EBC Annex 80 (Resilient Cooling of Buildings) al régimen árido de altura, incorporando: Indoor Overheating Degree (IOD), Climate Change Overheating Resistivity (CCOR), Unmet Degree Hours durante cortes de suministro (UDH), sensibilidad energética (ΔE/ΔT) y tasa máxima de cambio térmico interior (dT/dt máx). La librería procesa salidas de simulación de EnergyPlus y series de monitoreo empírico, e incluye generación de datasets sintéticos para verificación, pruebas unitarias automatizadas e integración continua. Se distribuye bajo licencia MIT con documentación completa, siguiendo principios FAIR: código versionado en GitHub, archivado con DOI en Zenodo y distribución vía PyPI.
Métodos
Los KPIs implementados se basan en el sistema IOD–AWD–CCOR del IEA EBC Annex 80 (Hamdy et al., 2017; Rahif et al., 2022), con extensiones para climas áridos de altura justificadas en la alta amplitud térmica diaria (>15 °C) del régimen BWk/BSk. Cada indicador se documenta con su dominio de entrada, función de agregación temporal, normalización y umbrales de referencia (ASHRAE 55, EN 16798-1). La verificación se realiza mediante datasets sintéticos con resultados analíticos conocidos y pruebas unitarias (pytest).
Información Técnica
Lenguaje: Python ≥3.10. Dependencias: ecosistema científico estándar (pandas, numpy). Suite de pruebas automatizada con integración continua (GitHub Actions). Documentación generada con Sphinx, publicada en GitHub Pages. Licencia MIT. Instalable vía pip (PyPI). Versionado semántico con archivado automático de releases en Zenodo.
Otro
Módulos: aridkpi.core (cómputo de los 5 KPIs núcleo), aridkpi.io (lectura de salidas EnergyPlus y series de monitoreo), aridkpi.synth (generación de datos sintéticos de verificación), aridkpi.viz (figuras estandarizadas). Incluye: README, CHANGELOG, CITATION.cff, documentación Sphinx, flujos CI/CD y suite de tests.
Colecciones
Condiciones de uso
Las buenas prácticas científicas esperan que se otorgue el crédito adecuado mediante una citación. Utilice un formato de citación y aplique estas normas de reutilización:
Licencia Creative Commons
Excepto donde se indique lo contrario, la licencia de este ítem se describe como by-nc-sa
Archivos
ARCHIVO
NOTAS DE USO
TAMAÑO
aridkpi_repositorio_completo.zip
270.5 KB