| name | simulate |
| description | Run EnergyPlus simulation and extract results in one step. Use when user says "simulate", "run simulation", or "run the model". |
| disable-model-invocation | true |
Simulate Current Model
Run a simulation on the currently loaded model and present results.
Steps
-
Save the model to a unique path under /runs/:
save_osm_model(save_path="/runs/<descriptive_name>.osm")
-
Ask the user which weather file to use. They must provide an EPW file path in the docker-mounted input directory. List available files if needed:
list_files()
-
Run the simulation:
run_simulation(osm_path="<saved_path>", epw_path="<user_epw_path>")
-
Poll until complete (check every 3-5 seconds):
get_run_status(run_id=<id>)
-
Extract key results:
extract_summary_metrics(run_id=<id>)
extract_end_use_breakdown(run_id=<id>)
-
Present a summary with:
- Total site energy (GJ and kBtu)
- EUI (MJ/m2 and kBtu/ft2)
- Unmet heating/cooling hours
- End-use breakdown by category (heating, cooling, lighting, equipment, fans, pumps)
Error Handling
- If no model is loaded, tell the user to load one first
- If simulation fails, show
get_run_logs(run_id=<id>) output
- Common failure: missing weather file or design days