How doctype02/plugin-ems works
This repository combines a Python building-energy digital twin and analysis workflow, a Node-RED live-control path, and a Grafana panel for monitoring, control, and interactive simulation. The main offline path runs climate and occupancy inputs through the simulator, building model, and controller, then supports scenario comparison, forecasting, validation, and KPIs. The live path connects the EMS to MQTT/InfluxDB and Node-RED. The README documents capabilities whose source was not sampled; their links are omitted or marked unverified where needed.
Main entry points: simulacion.py Twin simulation · cli.py CLI workflow · EmsPanel.tsx EMS dashboard · live.py Live MQTT loop
Components 27
Python EMS
- CLI workflow
ems/cli.py - Building config
ems/config.py - Climate input
ems/clima.py - Occupancy input
ems/ocupacion.py - Twin simulation
ems/simulacion.py - Thermal building
ems/edificio.py - Building events
ems/eventos.py - EMS control
ems/control.py
IoT Control
- Live MQTT loop
ems/live.py - Node-RED rules
nodered/src/ems_reglas.js - Manual control API
nodered/src/http_control.js - MQTT broker
- InfluxDB telemetry
ems/influx.py
Grafana Panel
- Grafana plugin
grafana-ems-panel/src/module.ts - EMS dashboard
grafana-ems-panel/src/components/EmsPanel.tsx - Building visualization
grafana-ems-panel/src/components/Building3D.tsx - Dashboard controls
grafana-ems-panel/src/components/BuildingControl.tsx - Demo simulator
grafana-ems-panel/src/building/simulator.ts - Panel telemetry
grafana-ems-panel/src/building/telemetry.ts - Incident simulation
grafana-ems-panel/src/building/events.ts
Analysis
- Scenario analysis
ems/escenarios.py - Load forecast
ems/pronostico.py - EnergyPlus validation
ems/validacion.py - Energy KPIs
ems/kpi.py - Reports
ems/reportes.py
Other components
- Operator
- EnergyPlus
Connections 32
- Operator → CLI workflow: runs commands
ems/cli.py - CLI workflow → Building config: loads settings
ems/cli.py - CLI workflow → Twin simulation: runs simulation
ems/cli.py - Twin simulation → Climate input: requests weather
ems/simulacion.py - Twin simulation → Occupancy input: requests occupancy
ems/simulacion.py - Twin simulation → EMS control: asks decisions
ems/simulacion.py - Twin simulation → Thermal building: applies commands
ems/simulacion.py - Thermal building → Building events: tracks incidents
ems/edificio.py - EMS control → Thermal building: uses zone model
ems/control.py - Twin simulation → Building config: derives zones
ems/simulacion.py - CLI workflow → Scenario analysis: compares strategies
ems/cli.py - Scenario analysis → Twin simulation: runs cases
ems/escenarios.py - Scenario analysis → Energy KPIs: computes metrics
ems/escenarios.py - CLI workflow → Load forecast: starts forecast
ems/cli.py - Load forecast → Climate input: uses climate data
ems/pronostico.py - CLI workflow → EnergyPlus validation: starts validation
ems/cli.py - EnergyPlus validation → Twin simulation: compares twin
ems/validacion.py - EnergyPlus validation → EnergyPlus: validates against
README.md - CLI workflow → Reports: writes outputs
ems/cli.py - Operator → Live MQTT loop: starts live mode
README.md - Live MQTT loop → MQTT broker: exchanges telemetry
README.md - Live MQTT loop → InfluxDB telemetry: stores live data
README.md - Node-RED rules → MQTT broker: runs EMS rules
- Manual control API → MQTT broker: publishes commands
README.md - Grafana plugin → EMS dashboard: registers panel
grafana-ems-panel/src/module.ts - EMS dashboard → Building visualization: renders building
grafana-ems-panel/src/components/EmsPanel.tsx - EMS dashboard → Dashboard controls: renders controls
grafana-ems-panel/src/components/EmsPanel.tsx - EMS dashboard → Demo simulator: shows demo state
README.md - EMS dashboard → Panel telemetry: reads live data
README.md - EMS dashboard → Incident simulation: simulates incidents
README.md - Dashboard controls → Manual control API: sends overrides
- EMS dashboard → InfluxDB telemetry: queries telemetry
README.md