> **Estado vigente, 30 septiembre 2026:** eficiencia relativa y energía evitable se calculan automáticamente con la [referencia transferida de renovación de AC](AC_RETROFIT_METHODOLOGY.md). Se mantiene el consumo de referencia sin calibración por AGEB; se declaran hipótesis y rangos amplios. Las conclusiones de indisponibilidad siguientes documentan la decisión anterior a autorizar parámetros transferidos. No se requiere introducir EER para habilitar el modelo nuevo.

> **Investigación adicional:** se ejecutó un prototipo con almacenamiento térmico y se recuperaron predictores ENVI de superficie/aislamiento para 297 AGEB. Son experimentos separados; el mapa conserva el motor de referencia anterior y no publica eficiencia territorial. Sus ceros de enfriamiento pueden resultar del umbral exterior, no de uso real observado. Resultados reproducibles en `docs/research/thermal-model-2026-09-28/README.md` del repositorio.

## Estado anterior — revisión de eficiencia, 28 septiembre 2026

El consumo residencial sigue siendo un modelo de referencia sin validación energética por AGEB. **No permite identificar la eficiencia real de cada zona.** La calculadora opcional de reemplazo de AC está separada del mapa y rankings de eficiencia/desperdicio. Introducir EER o precio no habilita esos indicadores. Se conservan como `unavailable` hasta incorporar características locales y una línea base defendible.

El problema no es únicamente falta de una fórmula: el motor actual usa la misma vivienda de 51.98 m² y EER 10 en todas las zonas. Con `S/E = (E_AC/E) × (1−10/EER_objetivo)`, el orden obtenido refleja participación del AC y la hipótesis del usuario, no diferencias identificadas de rendimiento o aislamiento. EER_objetivo=10 produce cero ahorro incluso para edificios desconocidos; elevarlo cambia el supuesto, no aporta evidencia territorial.

La calculadora sólo muestra en detalle el reemplazo hipotético de todo el AC a igual carga: `S = E_AC × (1−10/EER_objetivo)` y `MXN = S × precio_supuesto`. No es dinero perdido, factura CFE ni retorno de inversión. Sus entradas no alteran los rankings.

### Colores y fecha

Se conserva el slider diario y la interpolación continua `log(1+valor)` para consumo, con cero blanco y faltantes grises. Comparar días fija el rango a todo el horizonte; Explorar periodo lo recalcula con todas las AGEB del periodo. Filtros y viewport no cambian el rango. En modo dinámico no comparar tonos entre días sin consultar valores y leyenda.

### Modelo territorial requerido

La referencia debe responder: **energía necesaria para los mismos servicios en las mismas viviendas, con una configuración eficiente definida y verificable**. No es la AGEB que menos consume. La investigación, especificación de variables, ecuaciones y validación están en `docs/research/TERRITORIAL_EFFICIENCY.md` del repositorio.

Fuentes revisadas: [CONAVI/SEMARNAT, NAMA vivienda (2011)](https://www.conavi.gob.mx/images/documentos/sustentabilidad/4_Supported_NAMA_for_Sustainable_Housing_in_Mexico.pdf), enfoque de vivienda completa y monitoreo; [Muñoz López, Gutiérrez Sánchez y Quintana Pacheco (2023)](https://doi.org/10.29105/contexto17.26-373), comparación de prototipos en Hermosillo. Ninguna entrega etiquetas de eficiencia para nuestras AGEB. Los requisitos normativos citados históricamente deben verificarse para la fecha y tecnología del modelo; no se afirma cumplimiento normativo de las viviendas existentes.

### Revisión de precisión

Se revisaron nuevamente [ENCEVI 2018 y sus alcances](https://www.inegi.org.mx/rnm/index.php/catalog/495), su [diccionario de equipos](https://www.inegi.org.mx/contenidos/programas/encevi/2018/doc/encevi_2018_fd.pdf) y la [estrategia energética municipal](https://www.hermosillo.gob.mx/descargas/2025/agosto/estrategia-transicion-energetica.pdf). La base ENCEVI disponible tiene tipo, capacidad, días/meses y horas/minutos de uso de AC, y región/entidad de vivienda; no identifica una muestra representativa por AGEB Hermosillo. Sus variables de gasto no constituyen etiquetas kWh validadas. No se entrena ni calibra energía local utilizando gasto como si fuera consumo o medias regionales como si fueran mediciones AGEB.

Esta entrega mejora resolución visual, coherencia matemática y trazabilidad del escenario; **no demuestra mejora de exactitud empírica**. Para medirla faltan consumos residenciales observados compatibles en sector, periodo y geografía, separados en entrenamiento y prueba. Las limitaciones decisivas siguen siendo operación real de AC, área/envolvente de viviendas, tecnología/COP variable y validación de distribución espacial. Alterar parámetros sin ese contraste podría empeorar el pronóstico. Los colores continuos, el ajuste EIC y pasar kWh a pesos no validan el modelo. No se proporciona un porcentaje ficticio de accuracy.

---

## Registro histórico superado: interacción y escenario económico — 28 septiembre 2026

El día se selecciona con un slider (teclado: flechas, Inicio/Fin), tanto para el pronóstico como para los días históricos. La fecha activa se muestra explícitamente.

La escala del mapa y la leyenda de consumo ahora usan quintiles empíricos de valores positivos, agrupando TODAS las AGEB con geometría y TODOS los días del horizonte cargado. Para año histórico se usa la distribución anual; para día histórico, los 366 días. Cortes por rango más cercano en percentiles 20/40/60/80; se colapsan cortes repetidos y no se fragmentan empates. Cero y Sin datos se mantienen separados. Los cortes son idénticos al cambiar día, filtro, zoom o selección. Se recalculan al cambiar indicador, horizonte anual/diario o dataset: no son umbrales de eficiencia, peligro ni una escala comparable automáticamente entre versiones del pronóstico. Esta regla sustituye los cortes anuales /366 documentados en la versión anterior.

El detalle incluye un **simulador económico opcional**, sin precio o eficiencia objetivo prellenados. Costo equivalente = kWh modelados × precio uniforme elegido por el usuario en MXN/kWh. No es una factura CFE. La [tarifa 1F de CFE](https://app.cfe.mx/aplicaciones/ccfe/tarifas/TarifasCRECasa/Tarifas/Tarifa1F.aspx) se aplica por servicio residencial y tiene condiciones y bloques; [DAC](https://app.cfe.mx/Aplicaciones/CCFE/Tarifas/TarifasCREHogar/Tarifas/TarifaDAC.aspx) depende del promedio móvil de 12 meses de cada usuario. El agregado de una AGEB o siete días no identifica su tarifa ni subsidio. No se importaron precios sin verificar vigencia y cobertura.

La mejora técnica opcional compara el AC de referencia (EER 10 BTU/Wh configurado en el modelo) con un EER objetivo introducido por el usuario, ≥10 y con la misma métrica (no SEER). Al mantener carga térmica, confort, viviendas y horas constantes:

`Ahorro_kWh = E_AC × (1 − EER_referencia / EER_objetivo)`

`E_escenario = E_total − Ahorro_kWh`

`Valor_ahorro_MXN = Ahorro_kWh × precio_supuesto`

Se supone sustitución de TODO el AC representado y eficiencia constante; no se afirma que sea la eficiencia existente ni realizable en cada vivienda. Los demás usos permanecen iguales. El porcentaje mostrado es reducción de consumo en este escenario, no un score de eficiencia del AGEB. No usa la reducción de termostato como referencia eficiente. No calcula dinero perdido, energía desperdiciada observada, rentabilidad ni recuperación: faltan facturación por contrato, inversión, mantenimiento, vida útil y verificación de instalación/operación. Precio o EER faltante/incorrecto mantiene las salidas dependientes no disponibles; evita infinito por desbordamiento. Eficiencia y desperdicio principales continúan no disponibles como indicadores territoriales reales.

---

# Pronóstico residencial diario y referencia histórica

## Actualización del 28 de septiembre de 2026

**El horizonte predeterminado ahora contiene los próximos siete días, con clima pronosticado de 2026. No es una estimación anual de 2026.** La captura ejecutada cubre 2026-09-28 a 2026-10-04 y produce kWh/día para **503 AGEB censales, 502 con geometría en el mapa**. La AGEB 260300001017A tiene cálculo pero falta su polígono; no se inventa geometría. El selector conserva la referencia histórica 2020 de 388 AGEB, sin reescribirla.

### Qué se actualizó y qué sigue pendiente

- Meteorología: NOAA GFS (`gfs_seamless`) vía [Open-Meteo](https://open-meteo.com/en/docs/gfs-api), temperatura a 2 m, humedad relativa a 2 m y radiación de onda corta. Descarga horaria real, 168 horas completas; coordenadas solicitadas 29.08, −110.96; reloj America/Hermosillo. NASA POWER se mantiene para el histórico: su archivo no proporciona directamente estos días futuros. No se llama NASA al pronóstico de NOAA.
- Viviendas/equipamiento: **se actualiza al agregado oficial EIC 2025 de la localidad Hermosillo**, distribuyéndolo proporcionalmente según la estructura AGEB 2020 (257,876 viviendas cubiertas de 257,997 en la ciudad en 2020). La distribución es modelada. El parque 2025 se mantiene constante durante el horizonte 2026, sin inventar una tasa adicional de crecimiento. Por tanto, la salida es un pronóstico CONDICIONADO al parque de referencia, no una predicción validada del consumo actual de todas las viviendas de 2026. El denominador per cápita sigue siendo población 2020, no población actual.
- Calibración y precisión energética: continúan pendientes; no se atribuye un porcentaje de precisión a los kWh. El balance térmico descrito abajo conserva sus limitaciones. Cambiar el clima a 2026 no corrige por sí solo errores de tecnología, envolvente o comportamiento.

### Ampliación de 388 a 503 AGEB

115 AGEB adicionales tenían publicados total de viviendas, refrigeradores y lavadoras, pero faltaban márgenes auxiliares. El ajuste v2 usa sólo particiones completas publicadas: si falta un conteo de cuartos, omite TODA esa partición; si falta internet, omite ese margen. No obtiene celdas reservadas por sustracción ni reemplaza sus valores originales. Mantiene el ajuste completo para las 388 AGEB originales. Los nuevos perfiles quedan identificados `partial-margin-housing-profile`, con márgenes usados y omitidos y la causa original de exclusión.

Como diagnóstico, al retirar cuartos en las 386 AGEB con microondas publicado, el WAPE de microondas pasa de 10.7824% a 11.4314%. Esto respalda distinguir el ajuste reducido; **no valida AC ni consumo** y no demuestra mejor precisión energética. La mejora comprobada es de cobertura, manteniendo las restricciones observadas del perfil base 2020; el ajuste temporal posterior se describe abajo.

De las 665 filas censales quedan 89 excluidas por donantes no identificados a su localidad, 47 por campos necesarios faltantes/reservados y 26 con denominador cero. Hay además 147 polígonos del mapa sin cruce censal; tres filas censales no están dibujadas. No se asignan viviendas a esos polígonos por cercanía ni se reparte el residuo municipal entre las 503 AGEB.

### Reloj, caducidad y actualización

Open-Meteo define radiación como promedio de la hora precedente. La transposición solar usa el instante t−30 minutos y la suma diaria se agrupa por la hora final etiquetada; temperatura/humedad son del instante publicado. Esa aproximación de alineación está documentada, no se cambia a la convención NASA silenciosamente. Las 168 horas deben ser consecutivas, sin duplicados ni nulos, con unidades y geografía compatibles.

El generador rechaza pronósticos que no empiecen en la fecha local actual. Se conserva fecha de CONSULTA; no se inventa hora de emisión del modelo, que no entrega esta respuesta. La interfaz rechaza capturas de más de 48 horas o sin cobertura de hoy. No sustituye silenciosamente un pronóstico fallido por 2020, ni calcula total anual a partir de siete días. El artefacto almacena hashes de clima, parque y parámetros.

```sh
.venv-energy/bin/python scripts/energy/residential_coverage.py --housing-zip /ruta/al/Censo2020_CA_son_csv.zip
.venv-energy/bin/python scripts/energy/residential_forecast.py
```

`npm run data:energy:forecast` ejecuta el segundo comando con el Python activo. La adquisición se archiva en `data/energy-runs/`. El workflow existente incluye generación diaria y conservación del artefacto; **no despliega ni actualiza el sitio publicado por sí mismo**. Hace falta ejecutar ese flujo en el repositorio remoto y distribuir el JSON vigente al sitio para mantenerlo actualizado. Esta entrega local no afirma haber activado o desplegado ese servicio.

### Ruta para mejorar exactitud y actualizar viviendas

Se recuperó la ficha oficial de [SCIINCE EIC 2025](https://gaia.inegi.org.mx/sciince2025/) para **260300001, localidad Hermosillo**, no el municipio. Respuesta original: `docs/research/residential-forecast-2026-09-28/inegi-eic2025-hermosillo.json`. Consulta de lectura: `https://gaia.inegi.org.mx/sciince-services/indicators/datasheet?id=364&cvegeo=260300001&level=4`. Fuente interna explícita: INEGI EIC 2025; el universo excluye locales no construidos para habitación, viviendas móviles y refugios, compatible con el perfil base.

| Indicador EIC 2025 local      | Estimación publicada | Límites publicados | Error estándar publicado |
| ----------------------------- | -------------------: | -----------------: | -----------------------: |
| Viviendas con características |              291,844 |    265,638–318,050 |         15,854 viviendas |
| Dispone de electricidad       |                99.7% |         99.5–99.8% |               0.1 puntos |
| Aire acondicionado            |                95.8% |         94.7–96.7% |               0.6 puntos |
| Refrigerador                  |                98.8% |         98.4–99.1% |               0.2 puntos |
| Lavadora                      |                88.1% |         86.5–89.5% |               0.9 puntos |

Son **estimaciones de encuesta con error muestral**, no conteos observados por AGEB. Se preservan los límites originales sin atribuirles un nivel de confianza no verificado. Estos errores NO son errores de energía.

Actualización territorial: N_i,2025 = N_i,2020 × 291844 / 257997. Esto supone crecimiento proporcional de viviendas dentro de la cartografía 2020; no identifica nuevos fraccionamientos ni cambios de límites. El residuo de viviendas sin perfil se mantiene sin asignar, no se normaliza el total sobre las 503 AGEB disponibles.

Electricidad se aproxima con la tasa urbana 99.7%. Para AC, refrigerador y lavadora se aplica un desplazamiento común de log-odds a las probabilidades 2020 entre viviendas electrificadas: p'_i = logistic(logit(p_i) + b). Se encuentra b por bisección para reproducir la tasa EIC de cada equipo (condicionada a electricidad) en el parque representado. Conserva orden y cotas 0–1 y rechaza objetivos sin soporte; supone que las tasas publicadas de la ciudad aplican también al subconjunto cubierto. Es ajuste de EQUIPAMIENTO, **no calibración energética**, y todas las cantidades nuevas por AGEB son modeladas. No se modifican los conteos observados del Censo 2020 en Datos generales.

La sensibilidad térmica de la versión 2026 sólo cambia termostato 23→27.3 °C; después del ajuste EIC se utiliza el estimador puntual de AC. Los campos internos `knownAcHomes`/`unknownAcHomes` son compatibilidad del adaptador, no etiquetas de AC observado en 2025. La incertidumbre muestral EIC, el crecimiento territorial y la transferencia del parque siguen SIN propagarse al rango de kWh. No se interpreta ese rango como intervalo estadístico completo.

Para medir mejora de precisión se requieren recibos/energía residencial con fechas y geografía compatibles, dividir entrenamiento y prueba temporal/territorial antes de ajustar parámetros y comparar contra referencias simples. Deben reportarse MAE/WAPE/sesgo y cobertura por estación y AGEB; revisar AC, envolvente, horarios y fotovoltaica con datos locales. La validación del modelo zonal de todos los sectores no se transfiere al residencial. En esta versión se comprobó software, sensibilidad física y equipamiento; la precisión energética externa sigue **no evaluada**.

---

# Consumo residencial por AGEB: escenario de referencia 2020

Versión `residential-reference-2020-v1`, 27 septiembre 2026. **Estimación / modelo sin calibrar. No es consumo observado, predicción validada ni consumo actual.**

## Cobertura y significado

Se producen kWh anuales y diarios para 388 AGEB urbanas de la localidad Hermosillo, a partir de perfiles de 209,594 viviendas censales. El archivo conserva 665 filas censales; las restantes tienen valor nulo y causa explícita. El mapa conserva además sus polígonos sin correspondencia censal. No se extrapola al municipio completo ni a las AGEB rurales. Periodo: 366 días de 2020, UTC−7, 24 horas por día. La población del denominador también es de 2020.

El resultado responde: «¿cuánto consumiría este parque residencial bajo la vivienda, equipos y operación de referencia especificados?». No determina cuánto facturó CFE ni cuál AGEB necesita intervención. Los conteos censales son `observed`; los perfiles imputados y TODOS los kWh son `modelled`. Reservas, faltantes, universos incompatibles y ausencia de perfil son `unavailable`, nunca cero.

## Fuentes y parámetros

1. [INEGI Censo 2020](https://www.inegi.org.mx/programas/ccpv/2020/): conteos AGEB, electricidad, refrigerador y lavadora. Los perfiles de AC proceden del ajuste IPF del cuestionario ampliado local sobre márgenes de cuartos, refrigerador, lavadora e internet. Son hogares equivalentes estimados, no medidores ni número observado de equipos. El informe de distribución del repositorio documenta donantes, exclusiones y falta de respuesta. ENCEVI 2018 sirve como contexto; no se atribuyen sus promedios nacionales a una AGEB observada.
2. [NASA POWER, API horaria](https://power.larc.nasa.gov/docs/services/api/temporal/hourly/): T2M (°C), RH2M (%) y ALLSKY_SFC_SW_DWN (Wh/m² por hora) en 29.08, −110.96. Se archiva la respuesta completa 20200101–20210101 UTC para cubrir el último día local. Es clima en rejilla/reanálisis y producto satelital, común a las AGEB; no mide isla de calor individual. Un faltante en estas variables bloquea el cálculo, sin rellenarlo con cero.
3. Borbon-Almada, Rodriguez-Muñoz y Najera-Trejo (2019), _Energy and Economic Impact on the Application of Low-Cost Lightweight Materials in Economic Housing Located in Dry Climates_, Sustainability 11, 1586. [DOI](https://doi.org/10.3390/su11061586). Secciones 2.2 y tablas de materiales: vivienda de referencia de 51.98 m², altura 2.5 m, muro expuesto 43.78 m², ventana 7.41 m², SHGC 0.902, capas térmicas y techo blanco. No representa toda la distribución de edificios de Hermosillo. El estudio utiliza simulación dinámica; IRVEN NO replica su TRNSYS ni hereda su validación.
4. _A New Proposal for the Use of Cooling Degree Hours for the Energy Simulation of Residential Buildings in Mexico_ (2025), Energies 18, 4554. [DOI](https://doi.org/10.3390/en18174554). Tablas 2–3: referencia de EER 10 BTU/Wh, termostato 23 °C, electrodomésticos 3.14 kWh/día; refrigerador 128 W × 24 h × 0.3 = 0.9216 kWh/día; lavadora 400 W × 3 h × 0.05 = 0.06 kWh/día; ventilador 65 W × 5 h × 0.45 = 0.14625 kWh/día mayo–octubre. Activación exterior 29.2 °C para clima seco tomada de su ajuste. Son hipótesis publicadas, NO mediciones actuales locales. Sus errores de ajuste municipal no validan el algoritmo de IRVEN.
5. [NOM-020-ENER-2011, apéndice de cálculo](https://dof.gob.mx/normasOficiales/4459/sener1.htm): referencia técnica para resistencias y coeficientes superficiales hi=8.1, he=13 W/m²K. No se afirma certificación ni cumplimiento normativo del escenario.
6. [PsychroLib](https://github.com/psychrometrics/psychrolib), 2.5.0: relaciones psicrométricas ASHRAE. [pvlib](https://pvlib-python.readthedocs.io/en/v0.13.1/reference/generated/pvlib.irradiance.erbs.html), 0.13.1: posición solar, separación Erbs de GHI y transposición isotrópica a fachadas norte/sur iguales; albedo 0.25. Estas bibliotecas validan transformaciones, no el consumo residencial resultante.

Otros supuestos explícitos de IRVEN: ventana U=5.7 W/m²K; absorción de muro 0.60; 0.35 renovaciones/hora; humedad interior 50%; presión estándar 101325 Pa. La tasa de aire es un escenario, no infiltración medida. [EPA](https://www.epa.gov/indoor-air-quality-iaq/how-much-ventilation-do-i-need-my-home-improve-indoor-air-quality) cita 0.35 ACH junto con un requisito por persona: aquí no se certifica ese criterio combinado. Ninguno de estos valores debe presentarse como observado en las viviendas modeladas. Todos se conservan en `data/energy/residential-reference.json` con procedencia y supuestos.

## Ecuaciones

Para cada elemento, U = 1 / (1/hi + Σ espesor/conductividad + 1/he), en W/m²K. COP = EER / 3.412141633.

Para cada hora con T exterior ≥ 29.2 °C:

- Q sensible = Σ(U A)(T exterior − T interior) + caudal másico de aire × (1006 + 1860 w exterior) × ΔT + ganancia de aparatos.
- Q solar = U techo × A techo × absorción techo × GHI/he + U muro × A muro × absorción muro × irradiancia vertical/he + A ventana × SHGC × irradiancia vertical.
- Q latente = caudal másico × 2501000 × max(0, w exterior − w interior).
- kWh de AC de referencia = [max(0, Q sensible + Q solar) + Q latente] / COP / 1000 para una hora.

`w` es razón de humedad (kg agua/kg aire seco). Caudal másico = ACH × volumen / 3600 × densidad de aire seco. La entrada solar horaria Wh/m² equivale numéricamente a irradiancia media W/m² durante esa hora. Se utiliza el punto medio horario para posición solar. Fuera del umbral el AC se apaga por hipótesis operacional explícita, no porque exista una medición de apagado.

Base diaria de AGEB = viviendas electrificadas × (3.14 − 0.9216 − 0.06) + viviendas con refrigerador × 0.9216 + viviendas con lavadora × 0.06.

E(i,d) = Base(i) + viviendas electrificadas(i) × ventilación(d) + viviendas con AC estimadas(i) × enfriamiento de referencia(d).

AC desconocido se imputa a la tasa entre respuestas conocidas del perfil ajustado. La ganancia térmica de aparatos usa 3.14 kWh/día repartidos uniformemente en la vivienda de referencia. Cada vivienda con AC equivale a UNA configuración de referencia; no se conoce número/capacidad de aparatos. El total anual es exactamente la suma de los 366 días. No se divide energía municipal ni zonal para conseguir estas cifras.

## Calibración, incertidumbre y límites

Calibración: **ninguna**. El agregado municipal residencial 2022 recuperado no corresponde al año 2020 ni a la cobertura de 388 AGEB. CENACE zonal incluye otros sectores. No se usa ninguno para normalizar el escenario. La red de subestaciones tampoco permite asignar facturación sin conectividad y medición residencial compatibles.

Se publican escenarios bajo/alto: termostato 27.3 °C con ninguno de los AC desconocidos frente a 23 °C con todos los desconocidos. Es sensibilidad PARCIAL a dos hipótesis, no intervalo de confianza, error máximo ni cobertura estadística. No incluye incertidumbre de envolvente, horarios, COP, equipos, IPF o clima. La referencia a 27.3 °C cambia el servicio térmico: NO es una línea base eficiente y NO se convierte en desperdicio ni ahorro.

El balance es cuasiestacionario simplificado. Omite inercia térmica, conducción al terreno, ganancias de ocupantes, sombras reales, operación/ocupación horaria, límites de capacidad y COP variable. Asume acondicionamiento de toda la vivienda y misma envolvente en todas las AGEB. No incluye calefacción eléctrica, agua caliente eléctrica, generación fotovoltaica ni pérdidas de red. El inventario de 2020 y los parámetros de literatura de otros años no equivalen a datos contemporáneos. Estas limitaciones impiden afirmar precisión de consumo real o extrapolar a días futuros.

Para una predicción defendible de consumo real faltan facturas o energía residencial temporalmente compatible para calibración y validación independiente, además de distribución local de tecnología/capacidad/horarios/envolvente. La validación de microondas del IPF no valida AC ni energía. Las pruebas físicas y de software tampoco sustituyen la validación externa.

## Mapa y prioridades

Consumo por AGEB reutiliza E(i,periodo); por población usa E/POBTOT sólo con población positiva. La selección de año/día actualiza mapa, detalle y rankings. Los cortes anuales son explícitos (0, 250000, 1000000, 2500000, 5000000 kWh; por persona 0, 500, 1000, 2000, 4000). Los cortes diarios son esos valores /366, para una referencia fija; no son umbrales de eficiencia o peligro. Los valores extremos permanecen en el último intervalo. Sin datos es una categoría separada.

Eficiencia y desperdicio siguen `unavailable`: no existe línea base eficiente que mantenga necesidades comparables. El ranking general usa todo el universo disponible; el dinámico usa filtros territoriales explícitos, sin viewport. Clasifica escenarios de consumo y NO urgencia ni impacto causal de una intervención.

## Reproducción y validación

Desde la raíz del repositorio:

```sh
python3 -m venv .venv-energy
.venv-energy/bin/pip install -r scripts/energy/requirements-residential.txt
.venv-energy/bin/python scripts/energy/residential_energy.py
.venv-energy/bin/python -m unittest discover -s scripts/energy -p 'test_residential_energy.py'
npm test
```

La respuesta NASA archivada y los perfiles agregados permiten recalcular sin descargar ni cambiar silenciosamente los insumos. El JSON incluye huellas SHA-256 de entradas y parámetros, fuentes, periodo, calibración nula, causas de indisponibilidad y coeficientes diarios. Los tests verifican unidades, respuesta a temperatura/humedad/radiación, conservación anual-diaria, denominadores, faltantes y sincronización del mapa. No se atribuye precisión empírica al escenario.
